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PREFACE 


This manual describes ITAM/32 Character Synchronous Support. 
Chapters 1 through 4 describe the binary synchronous’ line 
drivers. Chapters 5 through 7 describe the binary synchronous 
terminal manager. It iS assumed that the reader has an overview 
of ITAM/32 as described in the O0S/32 Basic Data Communications 
Reference Manual. 


The RO2 revision of this manual revises the character synchronous 
device code section of Chapter 1. 


For further information cn ITAM/32 consult the following 
publications: 


MANUAL TITLE PUBLICATION 
NUMBER 


CS/32 Basic Data Communications 


Reference Manual $29-541 
OS/32 Asynchronous Communications 

Reference Manual 48-047 
OS/32 Bit Synchronous Communications 

Reference Manual $29-544 
CS/32 System Planning and Configuration 

Guide 48-024 
Synchronous Data Set Adarter 

Instruction Manual H29-277 
QSA Programming Manual C29-473 
32-Bit System User Documentation Summary 50-003 
IBM Binary Synchronous Communications GA27-3004-2 


For further information on the contents of all Perkin-Elmer 
32-bit Mahuals, see the 32-Bit Systens User Documentation 
Summary e 
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CHAPTER 1 
BINARY SYNCHRONOUS LINE DRIVER 
PROGRAM IDENTIFICATION 


1-1 INTRODUCTION 


This chapter describes the Perkin-Elmer ITAM Binary Synchronous 
Line Driver, Program Number 0O7-070F09. 


The following features apply to binary synchronous line driver 
Supports: 


@e ASCII and EBCDIC code set 

® Transparent text on ASCII and EBCDIC lines 

e Configuration Utility Program (CUP/32) assignment of 
translation tables. This permits flexibility in specifying 
line codes for individual lines. 

e User task modification of: 
- Error timeout values 
- Translation table selection 
- Output commands to control adapter and moiem 
- Number of leading sync characters transmitted 


- Transparent record size indicator 
(default values are listed in Appendix A) 


1.2 SUPPORTED DEVICES 


The binary synchronous line driver supports these devices: 


DEVICE 
CODE CODE 
Synchronous Set Adapter (SSA) 168 
Quad Synchronous Adapter (QSA) 168 


The QSA must be strapped for HDX/FDX only, as previously 
described. Other functions are under software control. 
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the binary synchronous line driver 
uses the binary synchronous communications (BSC) protoztol, with 
ASCII (even or odd parity) or EBCDIC line coie. Also, the line 
driver requires a Western Electric 201 or an equivalent moden. 


To communicate with terminals, 


With line driver (SVC 15) access, the uSer task is responsible 
for controlling all handshaking procedures of the line protocol. 
See Chapter 5 for terminal manager (SVC 1) access. 


1.3 DEVICE STATEMENTS FOR BINARY SYNCHRONOUS LINES 


The device statements for binary synchronous line devices must be 
included in the devices configuration statement at sysgen time. 


See the O0S/32 System Planning and Configuration Guide, or the 
OS/32 System Generation (SYSGEN) Reference Manual. 
1-4 RELATION TO OTHER PROGRAMS 
The ITAM binary synchronous line driver is an 35VC 15 driver. Tt 
requires the ITAM option of 0S/32. 
1-5 COMMAND REPERTOIRE 
The command repertoire for the binary synchronous driver is: 
XFER Transfer command chain address 
CXFER Conditional transfer 
WAIT Interval delay 
NOP No operation 
EXAMINE Fetch device status 
READ1 READ one byte 
READ2 READ two bytes 
READ BUFFER READ with ITAM buffer management 
PREPARE Search for particular character 
ANTI-PREPARE1 Search for specified character; 
on finding it, search for a character 
not equal to the specified character. 
ANTI-~PREPARE2 Search for character not eyual to 
specified character. 
WRITE1 WRITE one byte 
WRITE2 WRITE two bytes 
WRITE BUFFER WRITE with ITAM buffer management 
MODE Set programmable options 
RING WAIT Wait for phone to ring 
ANSWER Answer the phone 
DISCONNECT Hang up the phone 
Two options are included for binary synchronous I/0 with chained 


or queued buffers. These options require two extra bits (bits 2 
and 3) to be defined in the buffer flag byte. See Table 1-1. 
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TABLE 1-1 CHAINED/QUEUED BUFFER FLAG BYTE 


| BIT NO. 0 1 2 3 4 5 5 7 | 
eee er eee eae eae eee esos arse caee gereoe | 
| MEANING BUSY DONE ITB END TIB | 
{ TRANS | 
| SSS SSS SSS SV SS Swe SS SS SVS SS SS SSS SSS SS SS SS SS SS SS SS SS SS SS SS SS SS SSS STE | 
j; BIT 2 ITB | setting this bit directs I/0 to continue | 


| | with the next buffer of the chain, after | 
| | the handling of an ITB for this buffer. | 


| BIT 3 END | Setting this bit indicates that trans- | 
| TRANS | parent text mode may end in this buffer | 
| | if the last two characters of the buffer | 
| | are a proper termination sequence; ieee, | 
| { DLE, ETX. | 
[eee ee eee ee eS ge oe sees | 
| BIT 6 TTB | setting this bit indicates that this | 


| | buffer contains transparent text. | 


—— =m am oe om ow am ew ae om a ae ow & om a a 6 ow gp em om om om ae ow of ae om a» OO GR om a ae om om ow om ap Ge om am om @ ao oe om a @ om @ a ae o@ Ge & of aw = 


1-6 DCB FIELDS FOR BINARY SYNCHRONOUS LINE DRIVER AND TERMINAL 
MANAGER 


The list below specifies the DCB fields required by the binary 
synchronous line driver and terminal manager. These fields are 
in the ITAM portion of the DCB, which follows the basic DCB. 


DCB.XDCD Extended device code 

DCBeRECS Transparent records size 
DCBeSPCR Special character for read 
DCB.SPCW Special character for write 
DCB.XLT Translate table address 

DCB.-LDCT Count of leading sync characters 
DCB.PDCT Count of trailing pad characters 
DCB.LCB LCB Address 

DCB.IOBQ IOB (I/0 Block) queue header 


With the IOB queue, the binary synchronous terminal manager 
queves I/O requests previously put on hold because of a busy 
condition. 
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1-5 COMMAND REPERTOIRE 


The command repertoire for the BISYNC driver is: 


Two options are included for BISYNC I/O with 
buffers. 


XFER 

CXFER 

WAIT 

NOP 

EXAMINE 

READ1 

READ2 

READ BUFFER 
PREPARE 
ANTI~PREPARE1 


ANTI-PREPARE2 


WRITE1 
WRITE2 

WRITE BUFFER 
MODE 

RING WAIT 
ANSWER 
DISCONNECT 


Transfer command-chain address 
Conditional transfer 

Interval delay 

No operation 

Fetch device status 

READ one byte 

READ two bytes 

READ with ITAM buffer management 
Search for particular character 
Search for specified character; 
on finding it, search for a character 
hot equal to the specified character. 
Search for character not equal to 
specified character. 

WRITE one byte 

WRITE two bytes . 

WRITE with ITAM buffer management 
Set programmable options 

Wait for phone to ring 

Answer the phone 

Hang-up the phone 


chained or 


See Table i-1. 


queued 


These options require two extra bits (bits 2 and 3) to 
be defined in the buffer flag byte. 
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TABLE 1-1 CHAINED/QUEUED BUFFER FLAG BYTE 


MEANING BUSY DONE TB 


Setting this bit directs I/0 to continue with 
the next buffer of the chain, after the 
handling of an ITB for this buffer. 


Setting this bit indicates that transparent 
text mode may end in this buffer 
if the last two characters of the buffer are 
a proper termination sequence; ieew, DLE, ETX. 


BIT 6 TTB Setting this bit indicates that this buffer 
contains transparent text. 


1-6 DCB FIELDS FOR BISYNC LINE DRIVER AND TERMINAL MANAGER 


The list below specifies the DCB fields required by the BISYNC 
line driver and terminal manager. These fields are in the ITAM 
portion of the DCB, which follows the basic DCB. 


DCB.XDCD Extended device code 

DCB.RECS Transparent-records size 
DCBeSPCR Special character for read 
DCB.SPCW Special character for write 
DCB.XLT Translate-table address 

DCB.LDCT Count of leading SYNC characters 
DCB.PDCT Count of trailing pad characters 
DCB.~LCB LCB Address 

DCB.IOBQ IOB (I/0 Block) queue header 


(With the IOB queue, the BISYNC terminal manager 
queues I/O requests previously put on hold 
because of a busy condition.) 
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1.7 STATEMENT SYNTAX CONVENTIONS 


These statement syntax conventions are used in all instruction 


formats: 


CONVENTION 


Capital letters, 
parentheses, and 
punctuation marks 


Lowercase letters 


n 


Underlining 


PAUSE 


Ellipsis 


@#ee¢ 


Param,-eee, param, 


Lettering with shading 


Braces 
Brackets 


‘ 


Commas 


Braces inside brackets 


Bel 


1-6 


USAGE 


Must be entered exactly as shown 


Represent parameters or information 
provided by the user 


Indicates only the underlined por- 
tion of the entry is required 


Represents an indefinite number of 
parameters or a range of parameters 


Represents a default option 


Represent required parameters from 
which one must be chosen 


Represent an optional parameter that 
cah be chosen 


separate parameters and substitute 
missing positional parameters 


Represent optional parameters from 
which one can be chosen 
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Comma preceding braces 
inside brackets 


Lit] 


Comma inside brackets 


[| 


Comma outside brackets 
except last parameter 


ALL] b 


Equal sign separating 
keyword from parameters 


KEYWORD=paran 
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Must be entered if one of the 
optional parameters is chosen 
However, if the parameters are not 
positional and the first parameter 
of the statement is not chosen, the 
parameter specified as the first is 
not preceded by a comma. 


Must be entered if the optional 
Parameter is chosen 


Must be entered in place of missing 
positional parameters ani to 
separate optional parameters that 
are chosen. Commas are omitted for 
trailing parameters and a comma must 
be eantered with the last specified 
parameter. 


Must be entered to associate 
parameter with keyword 


1-7/1-8 


201 


CHAPTER 2 
INTRODUCTION TO BISYNC 


INTRODUCTION 


Following is a general description of the Binary Synchronous 
Communications (BSC) protocol applicable to the BISYNC line 
driver. A more detailed description can be found in General 
Information -- Binary Synchronous Communications, IBM Publication 
Number GA27-3004-2. 


A transmission on a BISYNC line consists of: 


A series of leading SYNC characters. These are needed to 
place the receiver into bit and character synchronization. 


Data and/or control characters. These are used to convey data 
and to enter and exit various modes that may add special 
meaning to any data. 


A trailing pad character. This ensures integrity of the last 
character of data. 


Example: 
Sss . P 
YYY DATA A 
NNN D 


BISYNC control characters, listed in Table 2-1, inform the 
receiving end exactly when to expect certain characters, such as 
a PAD. 
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TABLE 2-1 BISYNC CONTROL CHARACTERS 


. ASCII ASCII 
CONTROL CHARACTER CEVEN PARITY) (ODD PARITY) 


SYNC Synchronization 
character 


EBCDIC 


Negative 
acknowledgement 


End-~of-trans- 
mission 


Enquiry 
Start of header 


Start of text 


End-of-text 
(end-of-message) 


Data link 
escape (implies 
special meaning 
to the next 
character or 
characters) 


2e2 BISYNC TRANSMISSION MODES 


At any given time, a BISYNC transmission can be in one of the 
following three modes: 


@® control node 

® normal-text mode 

@e transparent-text mode 

Each mode has a unique purpose and a defined set of conventions 
for BISYNC transmission. The rest of this chapter describes 
these conventions. 

2e2e1 Control Mode 

Following is a description of BISYNC transmission conventions in. 


the control modes: 
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e A transmission always begins in the control mode. 


@e A transmission terminates from the control mode via: 


EOT 
ENQ 
NAK 
DLE "stick" 


In the EBCDIC character set, " 


the range X'60° thru X'7F 


In the ASCII character se 


ty “Ss 


characters listed below. 


characters, consult the 
Manual. 


IBM 


stick” represents any character in 
*. See Chapter 4, 


tick" represents one 
For more informa 
Binary Synchronous 


ASCII CHARACTER ASCII CODE 


e A transmission enters 
mode vias: 


oTX 
SOH 


e Atransmission enters 
control mode vias 


DLE,STX 
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the n 


the 


ormal-~text mode fro 


transparent-text 


of the four 
tion on these 
Communications 
m the control 
mode from the 
273 


Following are examples of transmissions using control mode only: 


202 


The 
the 


TRANSMISSION . MEANING 


SSSEP Line Bid 
YYYNA 
NNNQD 


S 
SSSDTP ACKO, ACK1, etc. 
YYYLIA 
NNNLCD 

K 


SSS E Data 
YYY‘ABCDEF‘O 
NNN T 


SSSNP Negative Acknowledgement 
YYYAA . 
NNNKD 


o2 Normal-Text Mode 


following describes the conventions of BISYNC transmission in 
normal-text mode: 


Normal-text mode is a variation in which a block check 
character (BCC) is accumulated over an entire block of text. 
Special characters have meaning. Chapter 4 defines the BCC 
and the “stick” characters. 


Normal-text mode is entered (and BCC reset to zero) via: 


STX 
SOH 


The end of the particular block and, therefore, the indication 


that a BCC follows is via: 


ETX followed by BCC and PAD 
ETB followed by BCC and PAD 
ITB followed by BCC (remains in the text mode) 
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Transparent-text mode can be entered from the normal-text mode 
via: 


DLE,STX 


Following are examples of transmissions using normal-text node: 


SSS5 E BP 

YYYTABCDEFGT C A 

NNNX xX C D 

SSS5 S EB P 
YYYOI2Z34TABCD TC A 

NNNH X BC D 

S855 IB I B EB P 
YYYTABCDTC EF GH T C IJKL TCA 
NNNX BC BC RD 


A temporary text delay (TTD) is sent as; 


STX, ENQ 


2e2e3 Transparent-Text Mode 


The following describes the conventions of BISYNC transmission in 
the transparent-text mode: 


Transparent-text mode, a variation of normal-text mode, allows 
all 256 8-bit patterns to be sent as data. 


It is entered from control mode or normal-text mode via the 
2~character sequence; 


DLE,STX | 


Cnce in the transparent-text mode, all 8-bit characters on the 
line are treated as data, except for DLE. If a DLE occurs in 
transparent text, the meaning of the next character is 
modified as follows: 


~ If the character following the DLE is another DLE, the 
sequence is interpreted as a single data character of DLE. 


-~ If the character following the DLE is a control character, 


the action is based on the specific character. Valid 
sequences are: 
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a Ce eee cune “ ome oom 


DLE, ETX Terminates transmission when followed by 


BCC,PAD 

DLE,ETB Terminates transmission when followed by 
BCC,PAD 

DLE, ENQ Terminates transmission when followed by 
PAD 

DLE,ITB Continues in normal-text mode when 


followed by BCC 


When the BISYNC line driver sends special characters over an 
ASCII line in control mode or normal-text mode, these 
characters have appropriate (even or odd) parity; the driver 
also expects received special characters to have appropriate 
parity. In transparent-text mode, however, the driver sends 
special characters over the ASCII line without parity and 
expects received special characters to have no parity. 


When reading any character from an ASCII line, the BISYNC line 
driver checks and strips the parity bit, and places the 
stripped character into the line buffer. But on detecting a 
parity error with a echaracter, the driver places that 
character--along with its parity bit--into the buffer and sets 
appropriate error status. 


Following are examples of transmissions using transparent-text 
modes 


Data Buffer: 


DS D I DE 
LTABCDLSHSTGLT (transparent data block of 10 characters) 
EX E B EX 


BISYNC Line: 


SSSDS DD I DEBP 
YYYLTABCDLLSHSTGLTCA 
NNNEX EE B EXCD 
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CHAPTER 3 
BISYNC LINE DRIVER 
FUNCTIONAL DESCRIPTION 


321 SUPPORTED COMMANDS 


The BISYNC line driver supports the following commands: 


XFER 

CXFER 

WAIT 

NOP 

EXAMINE 

RING WAIT 

ANSWER 
DISCONNECT 
READ,READ1,READ2 
PREPARE 
ANTI-~PREPARE1 
ANTI-~PREPARE2 
WRITE, WRITE1,WRITE2 
MODE Commands 


3-2 XFER 


This command obtains one data field specifying the address of the 
next driver command word (DCW). xXFER can be used to alter the 
normal sequential execution of the DCW chain. 


3-3 CXFER 


This command obtains two data fields. The first data field 
specifies a fullword with two halfword masks. The first halfword 
is ANDed with the present ITAM status. The result is compared 
with the second halfword: if they are equal, a command transfer 
takes place; otherwise, the next command in sequence is executed. 
The second data field points to the command to execute for a 
command transfer. 


NOTE 
The XFER and CXFER commands must be 


chained if they are to serve any useful 
purpose. 
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3-4 WAIT 


This command obtains one data field specifying the address of a 
halfword with a timeout count. The timeout count is in units of 
100 milliseconds (ms). A delay of this time period occurs before 
the command goes to completion. The precision interval clock 
ticks in units of 100 aos. So, depending on when the driver 
executes the WAIT command within any 100-ms unit, the actual wait 
period can be shorter than the specified wait period; 
specifically, the actual timeout is shorter than the specified 
timeout by a value less than 100 os. 


3-5 NOP 


This command obtains one data field, which the driver ignores. 
NOP is useful for reserving space in the command chain and the 
data chain. The data field must be a valid address (i.e., within 
user program space). 


3-6 EXAMINE 


This command obtains one data area specifying the address of a 
device-status byte. The driver fetches the latest device status 
from this byte for the user task: if that byte is nonzero, its 
contents are returned to the user and are reset to zero; if the 
byte is zero, a sense status is performed on the device, and its 
present status is returned to the user. 


NOTE 


The driver returns the status byte 
exactly as received from the adapter. It 
is the user's responsibility to 
understand what meaning any bit 
combinations may have at any given time. 
See Figure 3-1. 
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OVER- PARITY SYNC RING BUSY EXAMINE CARRIER DSNR 
FLOW DETECT OFF 


OVER~- PARITY SPECIAL RING BUSY EXAMINE CARRIER DSNR 
FLOW OFF 


CL25 


Figure 3-1 Synchronous Adapter Status Byte 


3-7 RING WAIT 


This command fetches no data fields. Interrupts from the adapter 
are enabled; however, the data-terminal-ready lead to the modem 
is not enabled. The command terminates when an interrupt is 
received with ring status set. If the DCW chain command bit is 
set, execution continues with the next command; otherwise, the 
driver terminates. If the DCW timeout bit is set, the command 
waits as long as the value specified in the write-timer halfword; 
when this interval expires, timeout error status is set. If the 
DCW timeout bit is not set, the command waits indefinitely. 


3-8 ANSWER 


For already connected nonswitched and switched lines this command 
terminates immediately. For unconnected dial-in lines the 
data-terminal-ready lead to the modem is enabled, causing the 
modem to answer the incoming call. When the data set indicates 
readiness for input/output (I/0), the command terminates. fhe 
DCW timeout and chain-command bits are handled as described for 
the RING WAIT command. 
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309 DISCONNECT 


This command disables the data-terminal-ready lead to the moden, 
causing a disconnect on a switched line. The command then waits 
for one second and continues to the next command (when the DCW 
chain-command bit is set) or terminates (when the chain-command 
bit is reset). 


3-10 READ, READ1, READ2 


These commands transfer data from the synchronous adapter to main 
memory. READ1 and READ2 obtain one data field specifying the 
address of a writable 1- or 2-byte area into which data is read. 
READ obtains one or two data fields, depending on which one of 


the three standard ITAM buffer-management techniques are 
specified in the data code of the first field obtained. One data 
field is obtained for indirect text and chained buffers. Two 


fields are obtained for direct text. 


The adapter is placed in SYNC-search mode and a read is 
performed. The first non-SYNC character is the first data 
character. . 


Special-character handling is designed to conform to the standard 
BISYNC line protocol. For a detailed description, refer to the 
flowcharts in Chapter 4. 


A series of internal indicators are maintained to control the 
progress of the read operation. There are two possible modes of 
operation once data transfer begins: control mode and text mode. 
The operations are controlled by the text-mode indicator which, 
when set, indicates that the driver is in the text mode; when 
reset, in the control mode. Additionally, the text mode can be 
in normal text or transparent text, as indicated by the 
transparent-text indicator. When data transfer begins, after the 
character rhase is established, the driver is placed in the 
control mode. In this mode, data characters (other than SYN) are 
stored in memory, without CRC accumulation, as they are received 
from the adapter. Another indicator is maintained to determine 
whether characters are to be converted from EBCDIC and stored in 
ASCII, or stored in EBCDIC as they are received. This indicator 
can be changed via the MODE TRANSL command, described in Section 
3.13. Special characters affecting the operation of the driver 
in the control mode can be divided into two categories: 
termination sequences and text-mode initiation sequences. 
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3.10.1 Termination Sequences 


Termination sequences are comprised of any one of the single 
‘characters ENQ, NAK, or EOT, or of any 2-character DLE “stick" 
character sequence. (A “stick” character is a character ranging 
from X‘'60° thru X°7F*.) After receiving a termination sequence, 
the driver reads one more character; if that character iS not a 
valid pad character (i.e., not in the range of X‘FO* thru X'FF‘), 
the driver terminates with “bad pad” statuse Receipt of ENQ or 
EOT is indicated to the user task by the SVC 15 status halfword 
(see Table 3-3). The pad character is not stored. 


3210.2 Text-Mode Initiation Sequences 


The text-mode initiation sequences consist of three possible 


sequences: SOH (one character), STX (one character), or DLE STX 
(two characters). SOH and STX place the driver into the 
normal-text mode; DLE STX places the driver into the 


transparent-text mode. 


In the normal-text mode, data characters other than SYN are 
stored in memory. Starting with the first character after STX or 
SOH, which initiated normal-text mode, the CRC-16 algorithn 
accumulates a BCC (block check character); SYN characters are not 
included in the BCC accumulation. The requirement for 
EBCDIC-to~-ASCII conversion is based on the same indicator used in 
the control mode. Control characters in the normal-text mode are 
any of the single-character ITB, ETB, ETX or ENQ sequences or the 
2-character DLE STX sequence. 


ITB, ETB, or ETX causes the driver to read two additional 
characters. These characters are combined to form a 16-bit BCC, 
that is compared to the BCC accumulated over the message; 
comparison failure causes the driver to set BCC error status. 


After ITB, the driver remains in text mode and restarts BCC 
accumulation. 


Setting bit 2 in the link word of chained buffers causes the 
driver to store the next block into the next chained buffer. 


After ETB, ETX, or ENQ, the driver 


e reads an additional character after the intervening BCC (no 
BCC is read after ENQ), 


e sets bad-pad status if the pad is invalid, 
@® resets text mode, 


® and terminates. 
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Receipt of the DLE STX sequence causes the driver to enter the 
transparent-text mode. If this sequence is received in the 
control mode, BCC accumulation begins with the next character 
after the DLE STX. In the text mode, the received sequence is 
included with the BCC being accumulated. An additional indicator 
is maintained to determine whether EBCDIC-to-ASCII translation is 
required in the transparent-text mode. In the transparent-text 
mode, the only control characters recognized are the 2-character 
sequences starting with DLE. They are interpreted as follows: 


@ DLE DLE results in a single DLE character being included in 
the BCC accumultion and stored in memory. 


e CLE SYN is discarded: however, the timer is reset to the 
read-error time value. 


e DLE ITB resets the transparent-text mode, leaving the driver 
in the normal-text mode. ITB is included in the BCC and 
stored. The next two characters read are compared with the 
accumulated BCC, as described above; the BCC is reset; and BCC 
accumulation begins with the next character. 


e DLE ETX and DLE ETB reset the transparent-text and the 
normal-text modes. ETX or ETB is included in the BCC and 
stored; a 2-byte BCC and a 1i-~byte pad are read and validated 
as described above. The command then terminates. 


e CLE ENQ resets the transparent and normal-text modes. A pad 
is then read and validated as described above. The command 
terminates. In the SVC 15 status halfword the ENQ bit is set, 
See Table 3-1. 


Any other sequence beginning with DLE resets the transparent and 
normal-text modes and results in driver termination with the 
error bit set in the SVC 15 status halfword (see Table 3-1) and 
with the termination code indicating a bad character sequence. 
See Table 3-2. 


NOTE 


The DLE of all transparent-text 
terminating sequences is not stored in 
the buffer; e.ge, for DLE ETX, only ETX 
is stored. 


The read-error timer is started when any READ command, with 
timeout specified, starts. If the read expires before an SOH, 
ETX, DLE STX, or a block-terminating character is received, the 
command terminates with a timeout and transfer-not-begun status. 
The timer is restarted (reset to read-error time) when SOH or STX 
is received, and thereafter when a SYN (DLE SYN in the 
transparent-text mode) or a block-terminating character is 
received. 
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TABLE 3-1 SVC 15 STATUS HALFWORD FOR BISYNC DRIVER 


oe ee ee ee ee 


PMEANINGPERROREBSYPNOT TIMEOUTTRESERVED] BCC FRESERVEDERESERVED 


ERROR 


WMEANING | EOT ENCODED 
TERMINATION CODE 
(See Table 3-2) 
STATUS MEANING DESCRIPTION 
BITS 
xX¥*'8000° Error Set for all error conditions. 


Certain conditions are not errors 
and do not set the error bit; @ege, 
special character detection. 


X¥* 4000" Busy The driver is still busy with SVC 
15 calls: can be cancelled via SVC 
15 halt I/0. 


X*2000° XFER Not Begun STX¥, SOH, or proper control-mode 
terminating sequence never 
occurred. 


1x°1000° Timeout Set if I/O timesout. 

X*OuOO' BCC Error Indicates BCC (CRC or LRC) error. 
X°0080' EOT EOT detected in data stream. 
1x*00u0° ENQ ENQ detected in data stream. 
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TABLE 3-2 ENCODED TERMINATION CODES 


ENCODED STATUS MEANING 
BITS 
No Errors No errore 


Data Check Terminated by data error3 
see bits 4 and 5. 


Buffer Limit Buffer limits reached 
without proper ending 
sequence. 


Bad Pad Pad character not 
received. 


Loss of Carrier Lost carrier on readse 


CL2S Error Lost clear-to-send 
write. 


Data Set not Ready Data set not ready. 


Device Unavailable Adapter not present. 
Overflow Character overflow. 


Ring Ring status detected 
during data transfer. 


Buffer Overrun 1 BSY and/or DONE bits in 
chain buffers bad; may 
indicate priority too low. 


NCE Overflow Number of commands 


executed is greater than 
2556 


Task Queve Error Task queue full, 
initialized, Or absent 
during attempt to trap; 
transfer questionable. 


Buffer Overrun 2 ESR did not execute in 
time; may indicate 
priority too low. 


Timeout Timeout. 
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TABLE 3-2 


ENCODED 
BITS 


15 
16 


17 


18 
19 
1A 
1B 
1C 


1D 


1E 
1F 


23 


24 


STATUS 


Halt I/0 


Trans Block Error 


Bad Character Sequence 


Illegal Command 
Memory Fault 1 
Memory Fault 2 
ITilegal LU 
Tllogical Status 


Power Fail 

Illegal Action 
Illegal Translation 
Table 

Queue Empty 


Queue Overflow 
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ENCODED TERMINATION CODES (Continued) 


MEANING 


Halt I/O request aborted 
1/0. 


Transparent block size 
error during write. 


Improper BISYNC sequence, 


Command or modifier not 
valid. 


Memory fault referencing 
datae 


Memory fault referencing 
buffer. 


Logical unit illegal (not 
SVC 15, not assigned). 


Device status not valid; 
may be hardware problem. 


Power failure. 


Tilegal 
condition. 


software 


Translaion table invalid. 


Queued buffer list empty. 


Queued buffer list 


overflow. 


3-11 PREPARE, ANTI-PREPARE1, ANTI-PREPARE2 


For a PREPARE, the data field points to a byte containing a 
prerare character. The adapter is placed into the SYNC-search 
mode, and the first non-SYNC character received is compared with 
this prepare character. If these two characters are unequal, the 
adarter is again placed into the SYNC-search mode. This process 
continues until the command timeout (if specified) expires, or 
until the received character equals the prepare character. Once 
the two characters are equal, the command is considered done and 
the next command, if chained, is executed. The received 
character is discarded. 


NOTE 


The special case of READ after PREPARE 
results ina lookahead to set up the 
READ. This allows the user to look for 
a special character and to read the 
following text without losing character 
synchronization. The received prepare 
character is not stored. . 


ANTI-PREPARE1 commands the BISYNC line driver to wait for a 
specified anti-prepare character; the data field associated with 
the ANTI-PREPARE1 points to a buffer containing this character. 
On receiving a character that matches the anti-prepare character, 
the driver places the adapter into the SY¥YNC-search mode. 


With the adapter in the SYNC-search mode, the driver then waits 
for a character that does not match the anti-prepare character. 
On receiving the first nonmatching character, the ANTI-PREPARE1 
is satisfied: the driver stores the character into the line 
buffer and acts on the next command--which must be a  READ-type 
command--to read the data following the anti-prepare character. 


ANTI-PREPARE2 commands the line driver to wait for a character 
that does not match a specified anti-prepare character; the data 
field associated with the ANTI-PREPARE2 points to ae buffer 
containing the anti-prepare character. On receiving the first 
non-matching character, the ANTI-PREPARE2 is satisfied: the 
driver stores the character into the line buffer and acts on the 
next command--which must be a READ-type command--to read the data 
following the non-matching character. 


3-12 WRITE, WRITE1, WRITE2 


These commands transfer data from main memory to the synchronous 
adapter. WRITE1-and WRITE2 obtain one data field specifying the 
address of a 1- or 2-byte area from which data is obtained. 
WRITE obtains one or two data fields, based on the ITAM buffer. 
management criterion for READ. 
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These commands first establish character phase by transmitting a 
fixed number of SYN characters. The number sent can be modified 
via the MODE SYCT command described in Section 3.13. Characters 
are obtained from memory and, depending on the setting of the 
control/normal-text code indicator, are converted from ASCII to 
EBCLPIC or transmitted as is (EBCDIC-to-EBCDIC). The characters 
are then transmitted to the data set adapter. Transfer begins in 
the control mode as it does with the READ commands. In control 
mode, the termination sequences ENQ, NAK, EOT, and DLE "stick" 
cause a pad character (X‘'FF*) to be sent after the terminating 
character, causing the command to terminate. 


The text-mode initiation sequences SOH, STX or DLE STX, described 
for the READ commands, place the driver into the normal or 
transparent~text mode. 


In the normal-text mode, characters are obtained from memory and 
sent to the adapter; ASCII-to-EBCDIC conversion depends on the 
setting of the control/normal-text code indicator. The BCC is 
accumulated exactly as with the READ commands, and the same 
control characters are recognized: ITB, ETB, ETX, ENQ, and DLE 
STX. 


The ITB, ETB or ETX sequence causes the driver to transmit the 
16-bit BCC as accumulated. After ITB, the driver remains in text 
mode, resets the BCC, and restarts BCC accumulation. After ETB, 
ETX or ENQ, the driver transmits a pad character (X*FF*) after 
the BCC for ETB or ETX, resets the text mode, and terminates. By 
setting bit 2 in the link word of chained buffers, text 
continuation after ITB is from the next buffer. 


After the DLE STX sequence, the driver enters the 
transparent-text mode, with BCC accumulation and ASCII-to-EBCDIC 
conversion taking place under the conditions described for the 
READ commands. By specifying EBCDIC-to-EBCDIC conversion, binary 
data can be sent; however, all special characters must be in 
EBCCIC. 


Termination sequences DLE ITB, DLE ETB, DLE ETX, and DLE ENQ are 
allowed. Their effects are the same as those described for ITB, 
ETB, ETX and ENQ. DLE is not included in the BCC accumulation. 
Any sequence other than these four will have unpredictable 
consequences. 


For multiple block messages, a SYNC-idle sequence (DLE SYN in the 
transparent-text mode; otherwise, SYN SYN) is inserted between 
blocks. Ensure that the transmission time for a single block 
does not exceed one second; iee@e, that block-size/line-rate does 
not exceed 0.125 bytes/baud. 


Transparent text in BISYNC allows transmission of all 256 8-bit 


patterns. Transparent text terminates via DLE ETX, DLE ETB, or 
another appropriate DLE sequence. 
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Once in the transparent-text mode (via the DLE STX sequence) 
during writes, the driver has no way of knowing where to end the 
transparent-text block unless there is a prearranged block size. 
Therefore, when using transparent data blocks, indicate to the 
driver when to exit from transparent text. This tells the driver 
that a particular DLE is not transparent data (which would be 
sent down the line as DLE DLE), but is a valid transparent-text 
terminating sequence. There are two basic methods for notifying 
the driver that transparent text is to ends: 


1- Transparent text can be transmitted in fixed-size blocks. 
The size of transparent records is generally a defined 
constant on any particular link, and is defined as a 
MODE-changeable parameter; default is 80 bytes. The MODE 
TRECS command, described in Section 3.13, can define the size 
of the actual transparent data. This size does not include 
either of the 2-character sequences necessary to enter and 
exit transparent mode. See Figure 3-2. 


2e Alternately, the user can place the 2-character terminating 
sequence as the last two characters of a buffer. Chained 
buffers must have bit 3 set in the flag field of the 
appropriate buffer. 


TRANSPARENT TRANSPARENT 
DATA DATA 


Figure 3-2 Transparent Record Size of 80 Bytes 
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3.13 MODE COMMANDS 


The MODE commands give the user the option to modify certain 
control parameters of the BISYNC driver. 


MODE commands take binary (hexadecimal) data from the user buffer 
and store this data within the DCB for later use by the driver. 
Since modification of DCB control fields can significantly impact 
the system, the user of a MODE command must be familiar with: 


e the structure of any control field to be modified 
@e the use of the control field by the BISYNC driver 


e the impact any modification might have on overall system 
operation 


The use of MODE commands is optional. With some MODE commands, 
knowledge of the compatibility between the modified control field 
and the adapter capabilities or any special adapter-strapping 
requirements and modem characteristics might be useful. Default 
control-field values are provided within the DCB; normal SVC 15 
I/O operations can be satisfactorily executed with these default 
values. Only the exceptional case requires a control field 
modification prior to I/O. Table 3-3 lists the MODE-changeable 
control fields and their default values. 
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TABLE 3-3 


COMMAND/ 
COMMAND FMODIFIER 
VALUE 


DESCRIPTION 


periods 


Modify Pro- 
grammable 
Adapter 
Initialization 
Command 


Modify Read 
Command 


Modify Write 
Command 


Modify Read- 
Disable 
Command 


Modify Write- 
Disable Command 


Modify Line- 
Disconnect 
Command 


Modify Count 

of Leading 

SYN Characters 
TRNSL Modify Trans- 
lation Table 
Use 


Modify Trans- 
parent Record 
Size 


rman, CUES cepene <CUNETD ETE SURE Coma SUB UNE SURETY come SINE SUEUR GENES monet: SET ME ues UNE GEE neue SREY SE See Sm SE GENS SE SEE EE GORE meee SMW ENE cogey SUA SME SEIN seer UN em Smee 
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MODE CHANGEABLE CONTROL FIELDS 


201 
DEFAULT 


SEC READ 
SEC WRITE 


N/A x! 


All ASCII 


80 bytes 80 
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QSA 
DEFAULT 


iat Te ee! Tene Pmeaneeeeenre 
Modify timeout 


6-SEC READ 
5-SEC WRITE 


30° 


‘All ASCII 


bytes 
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TABLE 3-3 MODE CHANGEABLE CONTROL FIELDS (Continued) 


Set Timeout Values 

The data field points to the first of two halfwords. 
The first halfword contains an error timeout interval 
for read-type operations; the second, an error timeout 
interval for write-type operations. Both intervals are 
in units of one second. 


Set Programmable Adapter Options 

Applicable only to the QSA; the data field specifies 
the command byte to be sent to initialize the adapter] 
to the correct data mode before any Read or Write 
operation. 


Enable READ Command 
Whenever the driver enters the read mode, the data 
field points to a byte for the output command. 


Bit combinations should correspond to adapter 
strappings, modems, etc. 


Enable WRITE Command 
Whenever the driver enters the write mode, the dataj] 
field points to a byte for the output command. 


Bit combinations should correspond with adapter 
strappings, modems, etc. 


Disable READ Command 

The data field points to a byte for disabling all READ 
commands. This disable occurs at normal completion or 
on any error condition. 


Disable WRITE Command 

The data field points to a byte for disabling all WRITE 
commands. This disable occurs at normal completion or 
on any error condition. 


Disconnect Switched Line 

The data field points to a byte for the line disconnect 
command. This command is issued when an SVC 15 control 
command is received with disconnect modifier (X‘'0018°) 
or when a final SVC 7 closes a communication line. 


Set Number of Leading SYNC Characters 

The data field specifies a byte conaining a 
right-Jjustified, single hexadecimal digit. This is the 
number, minus one (1), of the leading SYNC characters 
transmitted before each write. Its value ranges from 
X*O* through X‘F*. 
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TABLE 3-3 MODE CHANGEABLE CONTROL FIELDS (Continued) 


Set Translation Table Options 

The data field points to a byte specifying the type. 
translation for the control mode and 
transparent-text mode. The first 4-bit hexadecimal 
digit of the data byte indicates translation for input; 
the second hexadecimal digit, for output. The driver 
supports only the EBCDIC character set on the line. 
The internal code can be ASCII or EBCDIC. 


Cnce a code is assigned for a communications line, that 
code remains in effect until the next MODE command is 
executed for that line. The read and write digits do 
not have to be equal. 


For downline loads or for transmission of transparent 
8-bit binary data, EBCDIC transparent text must be 
used. This implies that only EBCDIC special characters 
(DLE, ETB, ETX, ITB, and SYNC) are recognized within 
the transparent block. 


Table 3-4 lists the possible translation options. 


Transparent-Record Size 

The data field points to a halfword containing the 
wanted transparent-record size. The halfword replaces 
the original value assembled into DCB.RECS. 
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TABLE 3-4 MODE CONTROLLABLE TRANSLATION OPTIONS 


CONTROL DESCRIPTION 
CODE 


INPUT: control, normal-text, and 
transparent-text characters are converted from 
EBCDIC to ASCII. 


OUTPUT: control, normal-text and 
transparent-text characters are converted from 
ASCII to EBCDIC. 


INPUT: control and normal-text characters are 
converted from EBCDIC to ASCII. 
Transparent~-text characters are not converted. 


OUTPUT: control and normal-text characters 
are converted from ASCII to EBCDIC. 
Transparent-~text characters are not converted. 


INPUT: control and normal-text characters are 
not converted. Transparent-text characters 
are converted from EBCDIC to ASCII. 


OUTPUT: control and normal-text characters 
are not converted. Transparent-text 
characters are converted from ASCII to EBCDIC. 


INPUT: no conversion takes place. 


OUTPUT: no conversion takes place. 


3213.1 Timeout Values 


There are two halfwords (READ and WRITE) that specify values, in 
seconds, for error timeouts. When a command specifies timeout, 
this time value is placed into DCB.TOUT and is decremented every 
second by the system clock. If the particular command is not 
completed within the allotted time, the entire SVC 15 call is 
aborted, and the timeout status bit is set. If there are no 
other encoded errors, the timeout code is also placed into the 
encoded portion of the status. If the timeout status bit 
(X°1000°) is set, and the encoded error is not timeout, the 
encoded error occurred first and might be the reason for the 
timeout. 
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There are separate time values for READ and WRITE. The data 
field of the MODE TOUT command specifies a fullword--the first 
halfword is the READ-error time value and the second halfword is 
the WRITE-error time value. Zero is not a valid time value. The 
actual timeout period can be shorter than that specified; 
specifically, the actual timeout is shorter than the specified 
timeout by a value less than 100 ms. 


3.13.2 Adapter Commands 


The BISYNC driver communicates with the synchronous adapter, 201 
adapter or Quad Synchronous Adapter (QSA), through a series of 
I/O commands. To maintain flexibility, all hardware commands the 
driver issues are obtained from bytes reserved in the PCB. Each 
command byte can be modified by issuing an appropriate MODE 
command. 


Figure 3-3 depicts the structure of the command bytes for the QSA 
and 201 Synchronous Adapters. Details concerning the use of 
these commands can be found in the M47-001 Synchronous Data Set 
Adapter Instruction Manual, (for the 201 Data Set Adapter) and 
the QSA Programming Specification Manual (for the QSA). 
Thoroughly review these publications before modifying any 
hardware commands. Of particular interest to the user of a QSA 
might be “local loop back" for back-to-back system testing. 
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201 ADAPTER COMMAND BYTE 


DESCRIP-|—DIS-  EN- PARITY | SYNC DATA 


TION ABLE ABLE MODE SEARCH | TERMINAL 
; (READ | READY 
ONLY) (DTR) 


a 


00 = No change 


01 = Enable interrupts 
10 = Queue interrupts 

but disable execution 
11 = disarm device from 


generating or queueing interrupts 
QSA COMMAND BYTE 
DESC FOR{FDISABLE ENABLE 


RECEIVE fi rs REQUEST 
MODE ENCODING TO SEND 


PDESC FORPDISABLE ENABLE i 0 


TRANSMIT SEE 201 REQUEST 
MODE ENCODING. } TO SEND 


DESC FOR NUMBER OF LINE CONTROL 
PROGRAN- , DATA BITS MODE 
MABLE SELECTED 

OPTIONS 

MODE 


ON ee ee 
OO= 5-Bit Char 00 = No Parity 


01 = 6-Bit Char 01 ZBID 


10 = 7-Bit Char 10 


Odd Parity 


11 8-Bit Char 11 = Even Parity 


Figure 3-3 291 and QSA Command Bytes 
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3-14 DCW OPTIONS 


The user can select four options by setting bits in the flag 
field of the DCW, as shown in Table 3-5. 


TABLE 3-5 DCW (DRIVER COMMAND WORD) HALFWORD 


COMMAND RESERVED MODIFIER COMMAND 
HALFWORD (4 BITS) (5 BITS) (3 BITS) 


Bit 0 Chain command If this bit is set, after execution of | 
the current DCW command, the next DCW 
command in sequence is executed. 
Otherwise, the driver terminates. 


Bit 1 Command trap If set and enabled, this bit generates af 
command trap to the calling task before 
DCW execution. 


Bit 2 Buffer trap If set and enabled, this bit generates a 
buffer trap when the first character is 
transferred and after each buffer is 
transmitted or filled. 


Bit 3 Timeout If set, this bit initializes an error 
timer before DCW execution. If the timer 
expires before the command completes, the 
SVC 15 aborts with a timeout status. 


If reset, this bit stops the timer. The 
command does not timeout. 


There are separate error-time values for 
read and write. 
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3-15 SVC 15 FUNCTION CODE OPTIONS 


The user can select four options by setting the appropriate bits 
in the function code of the SVC 15 parameter block, as shown in 
Table 3-6. 


TABLE 3-6 FUNCTION BYTE 


FUNCTION | HI/0O RESERVED 
BYTE 


Bit 0 Halt I/0 If set, this bit initiates a halt I/9 
sequence when the. driver is currently 
connected to this task, or when a 
condition code (CC=1) is returned 
indicating that the driver is not 
connected to this task. 


Bit 1 Command queue If set, this bit causes command-queue 
entries to be made as specified in the 
DCW: if reset, no entries are made. 


Bit 2 Buffer queue If set, this bit causes buffer-queue 
entries to be made as specified in the 
DCW; if reset, no entries are made. 


Bit 3 Termination If set, this bit causes a queue entry to 
be made (and a trap to be taken if 
enabled in the TSW) when the driver 
terminates. 
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CHAPTER 4 
BISYNC LINE DRIVER 
PRINCIPLES OF OPERATION 


4.1 INTRODUCTION 
The BISYNC line driver uses CCB.BMOD to maintain various 


pointers. Only the low-order 8 bits, bits 8 through 15, are 
used. See Table 4-1. 


TABLE 4-1 CCB.BMCD FLAGS 


CA RC CR CON CO CO KER CB 


RESERVED XFER TEXT §TRANS|E END NORMAL TEXT §TRANS TEXT 
NOT BEGUN §MODE §TEXT ETRANS XLATE XLATE 


Bit 8 XFER NOT BEGUN If set, this bit indicates input 
has not begune It iS reset by: 


EOT control mode 
NAK if in control mode 
ENQ if in control mode 
SOH if in control mode 
STX if in control mode 
Any proper “stick" 


Bit 9 TEXT MODE If set, this bit indicates the 
line is not in control mode, but 
in normal-text or transparent-text 

mode as determined by bit 10. 


Bit 10 TRANSPARENT TEXT If set, this bit indicates the 
line is in transparent-text mode. 


Bit 11 END TRANSPARENCY If set, this bit indicates that 
the previous character was a 
DLE and that the line was in 
transparent-~text mode at the 
time. 


29-543 R01 9/79 4-1 


Bits 8 through 11 are flags indicating the mode for the line 
protocol: i.e., control, normal-text, or transparent-text mode. 
These bits are manipulated by the BISYNC special-character 
routines. 


Bits 12 through 15 are translation table indicators for normal 
and transparent-text modes. These bits are assembled to indicate 
the translation required. DCB.XLT points to a table containing 
the addresses of several translation tables. At the beginning of 
any read or write, bits 12 and 13 are used as an index into the 
table; writes add 4 to this index. The address obtained is 
Placed into CCB.XLT. For transparent-text mode, bits 14 and 15 
are used as the index. Thus, by specifying different bit 
patterns for bits 12 through 15, different translations can be 
set up for reads and writes. 


4.2 WRITE OPERATIONS 


The WRITE command (WRITE, WRITE1, or WRITE2) performs these 
operations before branching to ITGETMCD: 


e loads register 2 with the write-device number 
e terminates call with "illegal instruction”, if zero 
@e loads register C with the address of the write CCB 


® initializes mode byte in CCB and sets CCBeXLT to the normal 
translation table 


e loads register 7 with the address of the command table 
e ioads register 6 with the maximum modifier value (3) 


@e branches on register A to ITGETMOD 


Address ITGETMOD branches to one of the three supported write. 
routines: WRITE1, WRITE2, or WRITEB. WRITE2 adds 1 to the 
options register U4 and enters WRITE1. WRITE1 adds 1 to the 
options register and enters WRITEB. 


Routine WRITEB calls ITGETBUF to completely set up the CCB for 
outrut with the appropriate buffer type. CCB.SUBA and CCB.CCW 
are now initialized. If the WRITE command is chained, a call to 
RAWCHR checks for read-after-write and, if necessary, sets up the 
read. The left digit of the SYNC counter byte is initialized at 
this time. The first driver ISR is now entered by a SINT. 


The ISR puts the adapter into write mode using DCB.MOCW and waits 
until the status is satisfactory for output. SYN characters are 
written until the SYNC counter overflows. The executive bit is 
set; the subroutine address is changed to BWISR2; and a buffer. 
trap is generated if requested in the command. The ISR then 
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exits by a load PSW instruction, and the output proceeds under 
control of the auto-driver microcode. The BQSAINIT is entered to 
set QSA programmable options, if required. 


AWISR2 is entered for one of two reasons: 
® error-status interrupt 
e buffer-limit interrupt 


Error-status interrupts are handled by BWSTAT. This routine 
analyzes the device status and terminates the call with the 
appropriate status. 


Buffer limit interrupts are handled by: 


@e changing CCB.SUBA to send two SYNC characters or, for 
transparent text, the DLE SYNC sequence 


e calling ITXFRISR to schedule the next buffer, if available 


A return from ITXFRISR indicates that no buffers are available 
and that a “buffer limit” error occurred. The buffer-select bit 
is complemented and the status is set to “buffer limit” by 
calling ITISSTAT. 


After returning from ITISSTAT, the write is aborted by sending: 
e EOT, if in control mode 

e ENQ, if in normal-text mode 

e DLE ENQ, if in transparent-text mode 


After the above characters and any valid terminating characters 
(ETX or BCC) are sent, two pad characters are written. 


The BISYNC protocol requires the first pad character and needs 
the second pad character to ensure that the first one clears the 
adapter. After the last character is accepted by the adapter, an 
"end buffer" routine is scheduled by a call to ITSRABS. The 
adapter is disabled using DCB.DOCW, and the ISPTAB is pointed to 
III, an OSs subroutine that ignores interrupts. If 
read-after-write is pending, the RAW bit is reset, and the DCW 
command pointer is adjusted, along with the number of commands 
executed, by calling ITWR.RD. The read ISR is now entered to 
begin the READ. 


If a read-after-write is not pending, calling ITSRABS' schedules 
the driver ESR. 
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4.3 READ OPERATIONS 


The beginning portion of a read operation is like that of a 
write. The read device number and the CCB address are loaded 
into registers; the modifier is fetched by branching to ITGETMOD 
using register UA. READ1 and READ2 add 1 and 2, respectively, to 
the options register and enter the normal code for READ BUFFER. 
ITGETBUF sets up the CCB just as in a write. The CCW is 
initialized to indicate write, translate, and ignore SYN detect. 
A check is then performed to see if this has been done on behalf 
of a read-after-write lookahead and, if so, control returns to 
the caller. Otherwise, CCB.SUBA and the ISPTAB entry are set up, 
and the driver READ ISRO is entered via a SINT instruction. 


The read ISR enables the adapter, placing it into read mode via 


DCB.MOCR. This command also places the adapter in the 
SYNC-search mode. All interrupts are then thrown away until a 
SYN arrivese The next character is checked for SYN and, if the 


character is a SYN, the execute bit is set; a buffer trap is 
scheduled; and input proceeds through the auto-driver channel. 
The BQSAINIT routine is entered to set QSA programmable options, 
if required. 


The driver is now entered only for: 

@® error-status interrupts 

e buffer-limit interrupts 

For either interrupt, entry to the driver is at BRISR3. 


Status errors are handled by BRISRSTA, which disables the adapter 
and returns the appropriate status. Buffer limits are again 
handled by calling ITXFRISR. If more buffers are available, the 
“next buffer™ routine is scheduled; otherwise, ITXFRISR returns. 
If the subroutine returns, the I/0 is aborted with a “buffer 
limit" error. 


When reset and started by the proper special character routines, 
a CRC or LRC is accumulated during the read. An LRC is 
accumulated during normal text mode on an ASCII idline; during 
transparent mode onan ASCII line, a CRC is accumulated. A CRC 
or LRC error results in "BCC or LRC error status"; however, if 
the CRC or LRC is followed by an ITB, the input continues until 
normal termination. An LRC is accumulated during normal text 
mode on an ASCII line; during transparent mode on an ASCII line, 
a CRC is accumulated. 
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The basic register convention for special-character handling in 
these routines is: 


~ EO PSW status 

E1 PSW location 

E2 Device number 

E3 Device status/characters 
E4& CCB address 

E5 DCB address, if needed 
E6 Mode flags 

E7 Work 


The routines that handle the special characters are written for 
general USC. They are entered with the translated and 
untranslated characters in registers. Reads require the 
untranslated character for inclusion in the CRC or LRC; thus, §E3 
contains the untranslated character, while F2 is loaded with the 
translated character. This register loading does destroy the 
device number; however, reads do not need it. 


Since the translated character is used for the CRC and since the 
device number is required to write it out to the line, write 
routines for special characters put the translated character in 
register 3. 


In front of the translation tables is a list of special 
characters as they appear on the line. All routines that require 
checking characters must check for the value on the line. For 
example, all writes in EBCDIC must perform a software translation 
to find out if a special character is an STX. 


4.4 PREPARE OPERATIONS 


The routine for the PREPARE is like the read routine. It fetches 
the data field by calling ITGETDAT. If not called by a TET 
E-task, it relocates the address and fetches the prepare 
character. This character is stored in DCB.CHAR3 a 
prepare-pending bit is set; and a read-after-write lookahead is 
performed by calling RAWCHKR. The read is then begun by 
branching into the read code at BRSTRT, and the normal-read ISR 
takes control. However, when detecting an SYN, CCB.SUBA is 
changed to the prepare ISR that ignores all further SYN 
characters. The first non-SYN character is translated and 
compared with the character in DCB.CHAR. If those characters are 
unequal, the adapter is again placed into SYNC-Search mode, and 
the cycle repeats. If the non-SYN character is equal to the 
prepare character, the prepare is Satisfied, and the 
prepare-pending bit is reset. If read-after-write (actually, a 
read-after-prepare) is pending, the execute bit is turned on, and 
the input continues as ae fread.e Otherwise, the adapter is 
disabled and the driver ESR is scheduled. 
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The routines for the ANTI-PREPARE1 and ANI-PREPARE2 are 
functionally equivelent to the PREPARE routine, with the 
exception that the driver searches for non-matching characters. 
See Section 3.11 for a further description. 


4.5 MODE OPERATIONS 


Most of the MODE commands are handled by the standard ITAM 
MODE~command executors. The MODE TRANSL command is unique to the 
BISYNC driver. This modifier returns to BMTRNSL after obtaining 
the relocated address of a data area (a byte consisting of two 
hexadecimal digits). The leftmost hexadecimal digit replaces 
bits 12 through 15 of CCB.BMOD in the read CCB. The rightmost 
hexadecimal digit replaces the same bits in the write CCB. 


4.6 CONTROL OPERATIONS 
EXAMINE is handled by the standard ITAM EXAMINE command executor. 


RING WAIT, ANSWER, and DISCONNECT are unique to the BISYNC driver 
because the required control bit and status bit are not 
compatible with other adapters. The logical flow is the same in 
all cases; however, the synchronous adapter provides the needed 
data-set-ready indication. 


4.7 NULL OPERATIONS 


NULL commands are handled by the standard ITAM NULL command 
executors. 


4.8 TRANSLATION TABLES 


The BISYNC line driver can be configured (via CUP/32) to work 
with one, two, or three sets of translation tables described 
belcw: 


@® kEven-Parity ASCII Translation Tables 


- for writing: internal ASCII to even-parity ASCII 

- for reading: even-parity ASCII to internal ASCII 

- for writing and reading: 8-bit to 8-bit (any DLE sequences 
are written without parity and are expected to be received 
without parity) 


@e Odd-Parity ASCII Translation Tables 


- for writing: internal ASCII to odd-parity ASCII 

-~ for reading: odd-parity ASCII to internal ASCII 

- for writing and reading: 8-bit to 8-bit (any DLE sequences 
are written without parity and are expected to be received 
without parity) 
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@ FBCDIC Translation Tables 


- for writing: ASCII-to-E8CDIC 

~ for reading: EBCDIC-to-ASCII 

- for writing and reading: 8-bit to 8-bit (any DLE sequences 
are written with characters of the EBCDIC set; received DLE 
sequences are also expected to be EBCDIC) 


Appendix C contains the values for the ASCII-to-EBCDIC and the 
EBCDIC-to-ASCII translation tables. As shown in these tables, 
the ASCII character set has 128 77-bit characters directly 
corresponding to 8~bit characters of the EBCDIC sete. But to 
identify the other 127 characters of the 254-character EBCDIC 
set, the ASCII code must have the parity bit set. 


An applications program must exercise caution when reading and 
writing data for a mix of EBCDIC and ASCII lines: the program 
must select only those 128 ASCII values that directly correspond 
to the EBCDIC characters. For example, suppose a task reads 
characters from an EBCDIC line and, via the EBCDIC-to-ASCII 
translation table, writes the translated characters over an ASCII 
line. For the 128 EBCDIC characters corresponding to the ASCII 
character set, the program encounters no difficulties in writing 


the translated ASCII characters over the line. But on receiving: 


any EBCDIC character that does not correspond to the ASCITI 
character set, the EBCDIC-to-ASCII translation table presents the 
program with an internal ASCII character with the parity bit set. 
When the program attempts to feed this character to the BISYNC 
line driver, which expects all parity bits reset, a parity error 
OCCULS. 


4.9 PROGRAM INFORMATION 

The ITAM/32 BISYNC Line Driver occupies approximately 5.5kb of 
system space that includes three 512-byte translation tables. 
Each line requires a DCB of 196 bytes, and 2 CCBs of 56 bytes. 


Standard default block size for transparent data is 80 bytes. 


Standard default for line code is EBCDIC; to SYSGEN a line for 
ASCII, refer to the ITAM/32 Reference Manual. 


Refer to Appendix A for default values of all MODE parameters. 


4.10 NOTES ON BISYNC LINE DRIVER 


The BISYNC line driver is assembled to handle BISYNC lines that 
pass both ASCII and EBCDIC character sets. 


In addition, the driver maintains separate indicators for 
transparent text as opposed to normal or control text. Thus, 
transparent text can be in EBCDIC (no translation), while control 
or normal text can go through the ASCII/EBCDIC translation. The 
option to allow ASCII-to-~EBCDIC translation in transparent text 
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is desirable because Perkin-Elmer machines are internally ASCII, 
whereas the line code is ASCII or EBCDIC. An ASCII-to-EBCDIC 
conversion is required to send alphanumeric and graphic data 
(ASCII in memory) asa transparent record (required by certain 
RJE protocols). This conversion translates ASCII graphics to the 
equivalent EBCDIC graphics. All other bit combinations translate 
to a unique 8-bit character. Thus, a one-to-one transformation 
exists between the ASCII and EBCDIC translation tables. A 
conversion of any 8-bit pattern from ASCII to EBCDIC and back to 
ASCII results in a null translation. 


In the ASCII character set, a "stick" character is one of the 
four characters shown in Table 4-2. The BISYNC line driver 
writes all ASCII stick characters with appropriate (even or odd) 


parity and expects to receive ASCII stick characters with 
appropriate parity. 


TABLE 4-2 ONLY STICK CHARACTERS FOR ASCII LINE 


ASCII LINE INTERNAL ASCII 


FUNCTION CCDE (HEX) 
GRAPHIC EVEN ODD GRAPHIC CODE 
PARITY PARITY (HEX) 


In the EBCDIC character set, a “stick” character is any 
character having the value of X‘'60° through X'7F°*. 

Table 4-3 shows the more frequently used stick characters for 
an EBCDIC line. 


Table 4-4 lists all of the possible EBCDIC stick values 
and their corresponding internal ASCII equivalents. 
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TABLE 4-3 FREQUENTLY USED STICK CHARACTERS 
FOR EBCDIC LINE 


FUNCTION GRAPHIC CODE GRAPHIC CODE 
(HEX) (HEX) 


~ 


DLE,X"70° 10,70 DLE,X*FO' 
DLE,/ DLE,/ 
DLEss DLEvs 
DLE,@ DLE,@ 


4-4 lists all of the possible EBCDIC stick values 
eir corresponding internal ASCII equivalents. 


TABLE 4-4 EBCDIC STICK CHARACTERS WITH 
INTERNAL ASCII EQUIVALENTS 


ASCII 
(INTERNAL) 
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NOTE 


Internal ASCII code for stick characters 
is different from the ASCII or EBCDIC 
line code. All tasks working with BISLNC 
protocol should be aware of this 
difference. 


4.11 DEFINITIONS OF TERMS 


e@ DCW CHAIN 


e *stick" 


e BCC 


Device Command Word Chain. Consists of 
sequential halfwords, each being one distinct 
command. ITAM drivers execute each command 


one at atime. The format is illustrated in 


Figure 4-1. 


c Cc B T NOT USED MODIFIER COMMAND 
C T 3 O BY DRIVER (5 BITS) (3 BITS) 


Figure 4-1 Device Command Word Chain Format 


A special 2-character sequence used in BISYNC, 
The first character is always DLE. For an 
EBCDIC line, the second character must be in 
the range of X*60° through X‘7F*. See Tables 
4-3 and 4-4, For an ASCII line, the second 
character must be one of the four hexadecimal 
values shown in Table 4-2. 


Block Check Character. Used for error 
detection in BISYNC. Cyclic redundancy 
checking (CRC) is used on EBCDIC BISYNC lines. 
Longitudinal redundancy check (LRC) is used on 
ASCII BISYNC lines during a read or write of 
normal text; but a read or write of 
transparent text uses CRC. 
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CHAPTER 5 
BISYNC TERMINAL MANAGER 
PROGRAM IDENTIFICATION 


5-1 INTRODUCTION 

This chapter describes the ITAM/32 BISYNC Terminal Manager, 
Program Number 07-O70F11. The ITAM/32 BISYNC Terminal Manager is 
part of the ITAM/32 Package. 

This buffered BISYNC terminal manager supports medium speed (1200 
to 9600 baud) controlled communications lines that use the IBM 
Binary Synchronous Communications Protocol for data transfer, 
error detection and error correction. Data can be formatted for 
the IBM 2780 or 3780 Remote Job Entry (RJE) terminals, or for a 
Perkin-Elmer processor-to-processor application using selected 
features of both the 2780 and 3780 systems. 

Features of the BISYNC terminal manager include: 

e SVC 1 device-independent access 

e Fully automatic recovery following line transmission errors 


e Built-in reduction of line-block transmission size during 
periods of excessive line errors 


e Data record blocking/deblocking for the user task 

e Space compression 

e Horizontal tabulation 

e Translation of selected printer-escape character sequences 
Data transfer assumes ASCII internal code and FBCDIC line code; 
the BISYNC terminal manager does not support ASCII line code. 
Limited conversational mode, automatic dial-out, and multipoint 
operation are not currently supported. 


5-2 REQUIRED LINE DRIVER 


The ITAM BISYNC terminal manager requires the ITAM/32 BISYNC Line 
Driver, Program Number 07-070F09. 
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5-3 REQUIRED HARDWARE 


The ITAM BISYNC terminal manager requires the following 


hardware: 


e Synchronous Data Set Adapter 201 (201 DSA) 
Product Number M47-000 


@e Quad Synchronous Adapter (QSA) 
Product Number 447-002 or M47-003 


e Western Electric 201 Modem, or equivalent 


5e4 DATA 


e QSA 


SET ADAPTER STRAPPING REQUIREMENTS 


- Strap SYNC character to X'32" (EBCDIC SYNC). 


- Leading SYNC-character suppression can be selected. 
operates with or without this optian. 


- Special status bit must not be activated. © 


@ 207 DSA 


~ Strap line to 2-wire or 4-wire, as required. 


- Strap SYNC character to X°32° (EBCDIC SYNC). 


- Strap character size to eight bits, no parity. 


5-5 SUPPORTED HODES OF OPERATION 


The ITAM/32 BISYNC Terminal Manager supports these 


IBM 3780 Remote Job Entry Data Format 
device codes 161 and 169) 


IBM 2780 Remote Job Entry Data Format 
device codes 162 and 170) 


Processor-to-Processor Interface 
device codes 163 and 171) 


These supported operation modes are described in the 


modes: 

@ BISYNC 
(0S/32 

e BISYNC 
(08/32 

® BISYNC 
(0S/32 

sections. 

5-2 


minimal 


System 


operating 


following 
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Lo ee a BISYNC IBM 3780 Remote Job Entry Data Format 


‘This Operational mode permits a user task to function like an IBM 
3780 RJE terminal while transferring data to or from an IBM 
360/370 or equivalent processor. 


Standard format features for the user include horizontal 
tabulation, trailing space truncation, internal space compression 
and expansion, and data record blocking/deblocking. 


52522 BISYNC IBM 2780 Remote Job Entry Data Format 


This operating mode permits a user task to function like an IBM 
2780 RJE terminal while transferring data to or from an IBM 
360/370 or equivalent processor. 


Standard format features for the user include horizontal 
tabulations, trailing space truncation, and data record 
blocking/deblocking. ES 


5.5.3 BISYNC Processor-to-Processor Interface 


This operational mode permits a user task to transfer data to and 
from a second processor configured with ITAM BISYNC support or 
with other similar BISYNC support. : 


Standard format features for the user include horizontal 
tabulations, trailing Space truncation, and data record 
blocking/deblocking. 


5-6 EXTENDED DEVICE CODE 


The ITAM extended device code (DCB.XDCD) must be specified at 
system configuration time for the Configuration Utility Program 
(CUP/32). Consult the 0S/32 Program Configuration Manual for 
operation of this program. 


Table 5-1 describes the ITAM extended device-code halfword and 
the options applicable to each device code. 


When a processor-to-processor connection is made, one end 
facility must be designated as the master station, and the other 
as its slave. This technique prevents clashes when the two 
connected facilities simultaneously bid for line write 
initialization. 
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TABLE 5-1 EXTENDED DEVICE CODES* 


MASTER LINE STATUS LINE PROTOCOL 
SLAVE RESERVED CODE CODE 
DEVICE Cones 


161/169] 162/170) 162/170] 163/171 


EXTENDED CODE 
(DECIMAL VALUE) 


a SAN ae 
Tare | med 
a 
a 
Tassie | we pm fo 
EO EC 
aa 
aa 
— 


ee ee 
es 
[wate vonner eure |e 
[ance poruex anne | vee 


* To formulate the extended device code, add the 
appropriate supported option within each of the three 
optional categories and use that value for the CUP 
extended-device option. 


Cas [1 


5-7 SUPPORTED ATTRIBUTES 


The BISYNC terminal manager supports SVC 1 data-transfer requests 
and command requests for read, write, wait I/0, write/read 
binary, unconditional proceed, image, write filemark, and proceed 
I/0. Other data transfer requests return an error status; other 
command requests are ignored. The device-independent extended 
ITAM options for connect, disconnect, and format are supported. . 
Device-dependent extended options include capabilities to 
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transmit transparent text, to receive sequences for eascape 
control characters, and to direct specific data buffering 
‘procedures. 


The BISYNC terminal manager is buffered; it employs internal data 
transfers within a line control block (LCB) for I/0 over the 
communications line. To facilitate this operation, SVC 7 
allocate requests are required to structure an LCB within 
available system space and to permit later line assignments. Two 
internal buffers are generated within each LCB. Default sizes 
for the logical record length and buffer size are described in 
Table 5-2. 


TABLE 5-2 DEFAULT SVC 7 ALLOCATION PARAMETERS 


DEVICE CODES LOGICAL RECORD LENGTH. BUFFER SIZE 


161,169 80 bytes 516 bytes 
162,170 80 bytes 4O4 bytes 
163,171 80 bytes 516 bytes 


5-8 SOURCE SYSGEN: HOW TO SUPPORT MPBSR 


All 32-bit processors equipped with the high-speed communication 
options provide the capability to use the move and process 
byte-string register (MPBSR) instruction. The MPBSR instruction 
improves performance in moving characters between the user-task 
buffer (defined by the SVC 1 parameter block) and the terminal 
manager internal buffer (part of the LCB), resulting in 
Substantial throughput improvement. 


The high-speed option is selected for system generation by 
modifying the source-equate MOVEINST from “MOVEINST EQU 0” to 
“MOVEINST EQU 1." This equate statement is found within the 
first 20 lines of the BISYNC terminal manager program. 
Reassembly of the BISYNC terminal manager is then required, and 
the OS/32 library loader must merge the new terminal manager into 
the combined driver library before using this library as input to 
CUP/32. It is necessary only that the new terminal manager 
precede the supplied object version in the library and follow all 
appropriate DCBs. It is not necessary to delete the old version. 
See the ITAM/32 Packaging Information Document and the 32-Bit 
Loader Description Manual for further information on merging 
system libraries. 
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CHAPTER 6 
BISYNC TERMINAL MANAGER 
FUNCTIONAL DESCRIPTION 


6-1 INTRODUCTION 


The BISYNC terminal manager processes all SVC 1 requests from the 
user task by converting the SVC 1 functions into parameters 
Processed by the SVC 15 BISYNC line driver. The BISYNC line 
driver accesses SVC 15 routines to drive the line hardware. 


The terminal manager, without specific direction from the user 
task, processes all protocol-required acknowledgements and 
general line controls. 


All reads and writes assume internal ASCII code for the processor 
and external EBCDIC code for the line. 


To prevent loss of communications line control, the line is 
considered busy during an entire read or write sequence. This 
busy condition is established by maintaining a connection between 
the task TCB and the driver leaf during the entire I/O sequence, 
and by setting busy flags within the line control block (LCB) and 
data control block (DCB). Before I/0, the line is considered 
idle. When the first I/O request is received, a busy condition 
is established, and the appropriate read or write BISYNC line 
initialization sequence takes place. Subsequent I/0 requests 
from other tasks are deferred pending line initialization. After 
line initialization, data reads or writes can be accomplished. 
The busy condition terminates when an EOT character (EOF 
condition on read), a write filemark, a write with the 
extended-option transmission bit set (see Section 6.9), an SVC 7 
close, or certain error conditions (see Section 6.7) is received. 


Since BSC is a half-duplex line protocol, the line stays busy 
during a single read-only or write-only transmission. 


Any read attempt during a write sequence or any write attempt 
during a read sequence results in an error. The one exception to 
this is FORMAT READ, described in Section 6.3. 


There are two BISYNC control character sequences: transparent 
and nontransparent. To prevent control errors (as opposed to 
text errors) during data transfers, certain control characters 
are not permitted in the text of a nontransparent data transfer. 
Transparent text, however, uses a data link escape (DLE) 
character to signify entrance or exit from a control character 
State, and thus permits any 8-bit character sequence within the 
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data field. To facilitate proper DLE insertion, all transparent 
writes must contain a record size equal to the logical record 
length specified during line allocation. Due to different means 
of control, interlacing transparent and nontransparent write 
requests is illegal. Failure to follow these procedures results 
in the return of an illegal function-code error to the user task. 


6-2 FORMAT WRITE 


When a write request is received, an idle line becomes busy and 
the terminal Manager initializes the line. The standard 
terminal-manager line initialization procedure consists of 
transmitting an ENQ character on the line and receiving the 
expected ACKO response. Failure to receive the correct response 
(or a line error) results in a predetermined number of retries 
and a final error return to the user task. 


After successful line initialization, user-task records are 
buffered into dynamic output buffers processed by the terminal 
manager. Formatting and buffering considerations are described 
in Section 6.10. 


6-3 FORMAT READ 


When a read request is received, an idle line becomes busy and 
the terminal manager initializes the line. The standard 
terminal-manager line initialization procedure consists of an SVC 
15 PREPARE that looks for a received ENO. A line error results 
in a predetermined number of retries and a final error return to 
the user task. 


Because no timeout is provided during the PREPARE, it is possible 
to remain in a read-initialization sequence for an indefinite 
period. If the line is in a read-initial PREPARE sequence, an 
ENQ character was not received. If a write request is received, 
the read-initialization sequence is halted, and a 
write-initialization sequence is initiated.» Similarly, an SVC 1 
halt I/O can be used to halt a read-initialization sequence. 


These capabilities permit a user task anticipating input or 
output to constantly leave a read-initialization sequence on the 
line to accept possible input, and yet be capable of breaking 
that sequence should an output be desired. 


After successful line initialization, records from dynamically 


controlled input buffers are moved into the user read buffer on 
each succesSive read. 
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6-4 IMAGE READ/WRITE 


These requests are processed with the user-program buffer for 
actual I/0. Line initialization procedures are identical to 
those of format read and format write. 


In image-write mode, the user program is responsible for 
providing correct BISYNC control-character sequences to frame 
output data. Detailed descriptions of BISYNC control-character 
sequences can be found in General Information -- S8inary 
Synchronous Communication, IBM Publication Number GA27-3004-2. 
A cursory review of BISYNC control characters is provided in 
Section 6.13. 


6-5 WRITE FILEMARK 


This command directs the terminal manager to transmit an E0OT 
character. For image write, this causes immediate scheduling of 
the single character write. For format writes the request is 
similar to a write request with the extended option bit 
transmission (bit 17) set. 


6-6 WRITE/READ BINARY 


Write or read binary is supported. For processor-to-processor 
operation (device codes 163 and 171), data is transmitted as 
transparent text, processed as ASCII data without any format 
controls, converted to EBCDIC on output to the line, and 
reconverted to ASCII input to the remote terminal. The remote 
terminal should be a similarly equipped Perkin-Elmer processor. 
For 2780 or 3780 operation (device codes 161, 162, 169, and 170), 
data is processed as binary transparent text and not converted on 
input or output. 


6-7 STATUS CODE PROCESSING 


The BISYNC terminal manager uses the standard SVC 1 
device-independent status codes as well as extended status 
information provided for the user program and placed in the 
device-dependent status field of the SVC 1 parameter block. This 
allows the user program to employ error-analysis routines 
identical to those for non-ITAM SVC 1 status analysis. For 
programs requiring further information, the user program can 
employ extended BISYNC status analysis. 


Table 6-1 illustrates the device-independent SVC 1 status codes 
used by the BISYNC terminal manager. 
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TABLE 6-1 SVC 1 DEVICE-INDEPENDENT STATUS CODES 


HEXADECIMAL CODE TYPE STATUS 


Successful completion 
ITllegal function 
Device unavailable 


End-of-file 


Unrecoverable error 


Illegal or unassigned 


Recoverable error (RVI) 


A busy condition on a line terminates whenever the terminal 
Manager returns an end-of-file or unrecoverable error status to 
the user task. No other type status affects a busy line 
condition. 


A recoverable error status is returned only after a reverse 
interrupt (RVI) on an SVC 1 write is received. Similar to a 
break ona teletype, RVI denotes successful transmission of data 
to a remote facility with the added indication that the remote 
facility wishes to terminate transmission, to reverse 
data-transmission direction, and to send a priority message. 
When a user task receives an RVI, it can either reverse the line 


or ignore the RVI by retrying the errored request. To reverse 
the line, the user task must issue a Write Filemark command to 
cease writing, or write a final data record with the 


extended-option transmission bit (bit 17) and issue an SVC 1 read 
request. 


NOTE 


No other recoverable error status returns 
are provided by the SVC 1 BISYNC terminal 
manager. The terminal manager 
automatically retries the normally 
recoverable errors according to BISYNC 
protocol conventions. Cnly if repeated 


retries fail is an unrecoverable status 
returned to the user program. 
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6-8 DEVICE-DEPENDENT STATUS CODES 


Table 6-2 lists the device-dependent status codes returned to the 
SVC 1 parameter block. 


The user program can ignore device-dependent statuses and depend 
solely on the standard device-independent status, or further 
analyze the extended status byte. Since the extended status is 
device-dependent on the BISYNC terminal manager, common routines 
that also analyze the extended status byte for other drivers may 
not be practical. 


TABLE 6-2 ITAM/32 BISYNC DEVICE-DEPENDENT STATUS CODES 


DEVICE- 
INDEPENDENT EXTENDED TYPE STATUS 
HEXADECIMAL STATUS CODES (EXTENDED) 

CODE 


01 Read request during writes or 
write request during reads 


02 Line error 

03 Hardware error 

o4 Message forward abort 

05 Message reject 

06 Halt I/O request 

07 Read image buffer too small 


08 Invalid image control 
characters 


09 Communications protocol error 
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Code 01 (Read Request during Writes 
or Write Request during Reads) 


Provided as an extension to the standard legal function code, 
code 01 indicates that a write request was attempted while the 
line was set busy with a read sequence, or vice versa. 


Code 02 (Line Error) 


Provided as an extension to the standard unrecoverable error 
status, code 02 indicates that garbled data or an excessive 
number of negative acknowledgements are being received, or that 
there is a Similar problem with the communications facility. 


Code 03 (Hardware Error) 


Provided as an extension to the standard unrecoverable error 
status, code 03 indicates loss of carrier, a possible inoperative 
adarter or modem, or a Similar hardware problen. 


Code 04 (Message Forward Abort) 


Provided aS an extension to the standard unrecoverable error 
status, code O4 indicates that the remote facility terminated 
message transmission before the normal end-of-message. 


Code 05 (Message Reject) 


Provided as an extension to the standard unrecoverable error 
status, code 05 indicates that the remote facility terminated 
receipt of message. 


Code 06 (Halt I/O Request) 


Provided as an extension to the standard unrecoverable error 
status, code 06 indicates that the user task terminated an 
outstanding I/O request. This error status terminates a read 
request -- still in the initialization phase -- in favor of a 
subsequent write request. 


Code 07 (Read Image Buffer too Small) 


Provided as an extended status to the standard unrecoverable 
error status, code 07 indicates that a read buffer was too small, 
preventing successful data input. This status might occur if an 
image read was attempted or if a format buffer generated during 
line allocation was too small. 


Code 08 (Invalid Image Control Characters) 


Provided as an extended status to the standard unrecoverable 
error status, code 08 indicates that a mismatch between sending 
and receiving protocols prevented proper data passage. This 
problem results from a connection with an untested BISYNC 
facility or from an unusual line condition. 
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Code 09 (Communications Protocol Error) 


Provided as an extended status to the standard unrecoverable 
error status, code 09 indicates that a mismatch between sending 
and receiving site protocol prevented proper passage of data 
traffic. This could result from a connection with an untested 
BISYNC facility or from a very unusual line condition. 


Code 00 (All Other Errors) 


All errors for which no specific extended status is reserved 
receive an extended status of 00. For example, a timeout for 
nonreceipt of data from a remote terminal receives a code of 00. 


6.9 ITAM EXTENDED OPTIONS 


The ITAM extended options are connect, disconnect, format, 
transparent, transmission, message, block, escape, receipt, and 
binary transparent. The following paragraphs describe each of 
these options: 


e Connect - Bit 0 (the high-order or most-significant bit) 


Used as an extended option for a read or write during the 
line-initialization sequence (see Section 6.3). Setting this 
bit directs the terminal manager to answer a telephone ring on 
a dial-in line. 


e Disconnect - Bit 1 


Used as an extended option for a read or writee Setting this 
bit directs the terminal manager to disconnect a switched line 
following final data transfer. 


e Format - Bit 2 


Used as an extended option for a read or write. Setting this 
bit directs the terminal manager to perform its normal record 
buffering, to insert or delete line control characters, and to 
recognize appropriate data~format control characters. 
Resetting this bit corresponds to SVC 1 image I/O. 


e Transparent ~- Bit 16 


Used as an extended option for a format write. Setting this 
bit directs the terminal manager to use transparent-text line 
control characters in message formatting. Transparent data is 
converted from ASCII to EBCDIC on output, and from EBCDIC to 
ASCII on input. 


e Transmission - Bit 17 
Used as an extended option for a format or image-write. 


Setting this bit directs the terminal manager to take all 
actions normally taken when the message bit (bit 18) is set. 
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In addition, an EOT character is transmitted after the final 
message block. The terminal manager idles the line after 
successful request completion. When the transmission and 
message bits are used together, the transmission bit has 
precedence over the message bit which, in turn, has precedence 
over the block bit. 


Message - Bit 18 


Used as an extended option for a format-write. Setting this 
bit directs the terminal manager to transmit all existing 
buffered records and to place an ETX as the terminating 
character of the final record. Successful completion is 
indicated when the final mesSage block is transmitted and 
properly acknowledged by the receiving facility. Therefore, 
setting this bit does not cause a line to be idled. The bit 
is usually set to distinguish each message among a series of 
messages sent on a single transmission. 


Block - Bit 19 


Used as an extended option for a format write. Setting this 
bit directs the terminal manager to complete its current 
buffer with the provided record, to place an ETB character as 
the terminating character of that record, and to transmit the 
buffered block. 


Escape Receipt - Bit 20 


Used as an extended option of a format read. Normally, the 
BISYNC (escape) ESC character is removed from a received 
record and translated into an appropriate series of ASCII 
characters if possible. Setting this bit allows the ESC 
character sequence to he passed to the user buffer. 


Rinary Transparent ~- Bit 21 


Used as an extended option for format read or write. On 
writes, setting this bit directs the terminal manager to use 
transparent-text line control characters in message formatting 
and to inhibit ASCII-to-EBCDIC conversion of transparent text 
during output. On reads, setting this bit directs the 
terminal manager to inhibit EBCDIC-to-ASCII conversion of 
transparent text during input; conversion of received normal 
text still takes place. When the binary transparent and the 
transparent bits are used together, the binary transparent bit 
takes precedence over the transparent bit. 


6-9.1 Default Extended Options 


Table 6-3 shows the extended options the terminal manager 
defaults to when no options are selected from the SVC 1 ITAM 
extended-options fullword. 
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TABLE 6-3 DEFAULT EXTENDED OPTIONS 


FUNCTION DEVICE CODE DEFAULT EXTENDED OPTIONS* 


ASCII read/write 161/169 Format, escape receipt 
ASCII read/write 162/170 Format, escape receipt 
ASCII read/write 163/171 Format 


Binary read/write 161/169 Format, escape receipt, 
binary transparent 


Binary read/write 162/170 Format, escape receipt, 
binary transparent 


Binary read/write 163/171 Format, transparent 


*Format = bit 23; escape receipt = bit 20; 
binary transparent = bit 213; transparent = bit 16. 


6-10 FORMAT AND LINE CONTROL 


The BISYNC terminal manager has format capabilities for various 
device-code read/write combinations.e. AS an assembly option, it 
is possible to modify processor-to-processor capabilities for 
System needs. The following sections describe each of the 
available format capabilities. 


6-11 FORMAT CAPABILITIES 


62-11-21 Space Suppression 


Space suppression processes the ASCII group separator (GS) 
character as a substitute for an internal string consisting of 2 
to 63 sequential spaces. On output, when two or more SpaceS are 
found within the text, a 2-character sequence consisting of the 
GS character plus an encoded space count is substituted for the 
Space string. On input, when a GS character is found, the 
subsequent encoded space-count character is checked, and the 
appropriate number of spaces is inserted. 
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6.11.2 Trailing Space Suppression 


Trailing space suppression truncates trailing space characters in 
an output record and replaces’ them with an appropriate 
record-termination character (ETB, ETX, ITB, or EM). 


6-11-23 Horizontal Tabulation 


Horizontal tabulation processes the horizontal tabulation (HT) 
character as a tab indicator for input records. To set 
tabulation, the first record of an incoming message must be 
flagged with a starting ESC character, followed by an HT 
character. Subsequent character positions should contain an HT 
wherever a horizontal tab is needed. Horizontal-tab analysis is 
terminated when a new line (NL) character is receivede All other 
character input is ignored. The terminal manager develops a 
horizontal-tabulation bit map from this record and skips to the 
next record. For subsequent records, a received HT directs the 
user record-character input pointer to be updated, as indicated 
in the bit map. Intervening positions are filled with spaces. 


6211-4 Escape Character Recognition 


Escape-character recognition recognizes the ASCII ESC character 
as the first character of a record. If the escape-receipt bit 
(bit 20) is set in the ITAM extended options, the 2-character ESC 
sequence is moved into the record. Otherwise, the ESC sequence 
is converted to an equivalent ASCII control character, if 
possible, or it is bypassed. 


For ESC character sequences converted to equivalent ASCII 
character sequences, the escape-printer control sequence is 
provided after the record containing the esScape control. This 


directs the printer-control sequence, a vertical tab for example, 
to be executed after the record to be printed. The actual data 
record and control sequence are passed to the user progran 
through two sequential SVC 1 reads. The data record is provided 
for the first read. The ASCII printer control sequence is 
provided for the second read. See Table 6-4 for a description of 
escape character sequences and their equivalent ASCII control 
characters. 
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TABLE 6-4 ESCAPE CHARACTER SEQUENCES 


CODE MEANING SECOND RECORD 
SEQUENCE ASCII CONVERSION 


SINGLE SPACE N/A 
DOUBLE SPACE SPACE,CR 
TRIPLE SPACE LF,CR 
SKIP TO TRACK FF,CR 
VT,CR 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
N/A 
SKIP TO TRACK N/A 
SKIP TC TRACK N/A 
SPACE SUPPRESS N/A 


CODE MEANING SECOND RECORD 
SEQUENCE ASCII CONVERSION 


SINGLE SPACE N/A 
DOUBLE SPACE SPACE,CR 
TRIPLE SPACE LF,CR 
SKIP TO TRACK FF,CR 
VT,CR 
N/A 
N/A 
N/A 
N/A 
N/A 
SKIP TO TRACK N/A 
PUNCH SELECTION N/A 
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6.11.5 Carriage Return 
The carriage return (CR) terminates a record at the recognition 


of an ASCII CR character. For reads, all short blocks are 
terminated when a CR is inserted in the user buffer. 
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6.11.6 End-of-Mediun 


End-of-medium terminates a record when an ASCII EM character is 
reccgnized. ° The EM character is processed the same as a CR on 
write. For read, a CR is passed to the user buffer in lieu of an 
EM character. 


6211.7 Unit Separator 


Unit separator inserts or deletes the ASCII US character as a 
record separator within a block. This insertion allows more than 
one record to be included within a transmission block. 


6211-8 Transparent Text 


Transparent text allows transparent-text control characters to be 
recognized and inserted for data buffering. The following is 
implied by the use of transparent text: 


@ Any 8-~bit character can he provided by the user program within 
a data record. Data transmission cantrol is totally 
transparent to data content. 


@e All data records must have a record length equal to the record 
length specified at line allocation time. 


® The terminal manager does not recognize escape characters, 
horizontal tabulation, trailing space suppression, or space 
compression. 


e® Cnce specified for a data message, transparent text is assumed 
for all message transmission or reception. If transparent 
text is not specified for the first record of a message, it 
cannot be specified later. 


e Cn reads, control characters within the received data 
determine transparent-text processinge 


e Multiple-record block buffering is provided. 


6-12 RECORD BUFFERING 


-Record buffering is provided for all format read/writes. Image 
read/writes have no record buffering. Following is a definition 
of buffering terms: 


@ Record 
User data contained ina single read or write request usually 
consist of a single 80-character card image or a single 80- to 


WOn-character print line. LRECL specifies maximum record size 
at allocation time. 
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@® Block 


A block consists of one or more records buffered for a single 
BISYNC line communication. Each record is expanded to include 
BISYNC record separators and block delimiters. Each block is 
terminated by an ASCII ETB or ETX character. BSIZE specifies 
maximum block size at line allocation time. 


r Message 


A message consists of one or more blocks transmitted in a 
BISYNC line communication. An ETX character terminates the 
last message block. 


e Transmission 


A transmission consists of one or more messages transmitted in 
RBISYNC line communication. An ASCII EOT character normally 
terminates a transmission. 


6.1221 Transmission, Message, Block and Record Relationships 


In BISYNC, several records can be combined into a single block. 
Blocks can then be combined into a single logical message, 
several of which make up a fhysical transmission. 


The terminal manager buffers user records into a block. The 
number of records buffered into each block depends on block size 
and protocol characteristics. If the user sets the 
extended-option block bit (bit 19), buffering of that block 
ceases, and the block is transmitted. If the user sets the 
extended-option message bit (bit 18), buffering of that block 
ceases; the protocol-dependent end-of-message indicator is set in 
the block, and the block is transmitted. If the user sets the 


extended-option transmission bit (bit 17), all 
message-termination actions, as above, are taken, and a 
protocol-dependent end-of-transmission indicator is also 


transmitted. An SVC 1 write filemark also directs transmission 
of all buffered records and an end-of-message indicator ina 
manner similar to setting the extended-option transmission bit 
within a write request. 


Dynamic line buffers are provided for record buffering at SVC 7 
line allocation time. All pointers to these blocks, along with 
the counters and internal indicators to control them, are 
provided within the LCB. Only a single set of these buffers is 
required for input or output. 


For writes, when a record is received from the user program, it 
is first formatted or compressed in accordance with device 
conventions and then moved into the next available position 
within the active output block buffer. The terminal manager 
determines whether to hold the block buffer to receive subsequent 
writes and immediately return to the user or to queue it for 
write. A transmission is scheduled if the remaining space in the 
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block prevents the insertion of a subsequent record or if the 
number of records within the block reaches a predefined point. 


The 3780 protocol subset, for example, permits only seven records 
to be inserted within a block. Setting the extended-option 
transmission bit, message bit, or block bit also causes 
transmission scheduling. When a transmission is scheduled, 
immediate return to the user takes place if a second internal 
buffer block is available to receive future writes. If a second 
block is not available because both blocks are currently busy 
with previously scheduled transmission requests, return to user 
is delayed until a previous transmission is completed. 


For reads, the terminal manager attempts to read ahead into 
available input block buffers. When a read request is received 
from the user program, the terminal manager determines whether an 
active input deblocking buffer is available. If one is not 
available, processing delays until a successful read completion 
makes such a buffer available. Otherwise, the next sequential 
recerd is removed from the deblocking buffer, formatted or 
expanded as required, and moved to the user-program read buffer. 
Return to the user then takes place. When a deblocking buffer is 
emptied, it is flagged as available for additional reads. 


ITAM extended-option settings for block, message, or transmission 
bits, or the receipt of a read ETX character takes precedence 
over normal record buffering. The user program might be behind 
the terminal manager on reads, or ahead of it on writes. 


6-13 USE OF CONTROL CHARACTERS FOR DATA FRAMING 


Before each transmitted block, the line driver includes line 
synchronization characters. It also terminates each block or US 
character with a cycle redundancy check (CRC) block-validation 
sequence. No CRC is provided after an RS character. 


Any character can be included within transparent text since only 
those control characters preceded by a DLE are recognized. The 
line driver modifies each DLE character within the text to a DLE 
sequence, 


Within nontransparent text, only the GS, ESC, HT, EM, CR, FF, and 
VT control characters can be included in the record text for 
their defined purpose. All other control characters, listed in 
Table 6-5, cannot be in data text. 
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TABLE 6-5 BISYNC CONTROL CHARACTERS 


STANDARD 
CHARACTER ABBREVIATION 


Start of header 

Start of text 

Enquire 

Data link escape 

Negative acknowledgement 
End-of-transmission block 
End-of-text 

Intermediate transmission 
block 

Unit separator 

Record separator 

Line sync 

End of medium 

Horizontal tab 
End-of-transmission 
Escape 

Generate spaces 

Carriage return 

Form feed 

Vertical tab 


6.14 TRANSPARENT VS BINARY TRANSPARENT TEXT 


There are subtle differences between transparent text and binary 


transparent text. In both cases, identical control-character 
sequences permit any binary character to be transmitted; all 
format characteristics apply. However, user-data translation 


procedures are different. 


6214.1 Transparent Text 


Data is converted from ASCII to EBCDIC on output and from EBCDIC 
to ASCII on input. Complete 256-character ASCII and EBCDIC 
translation tables provide a one-to-one correspondence between 
each ASCII character and its equivalent #BCDIC character. 
Special 8-bit ASCII characters above 127 have been invented to 
facilitate translation of the complete EBCDIC set into ASCII. 
See Appendix C. If transmission is between two Perkin-Elmer ITAM 
facilities, data is translated from ASCII to EBCDIC on output and 
back to original ASCII. on input. For Perkin-Elmer to 
Perkin-Elmer communication, data translation is transparent to 
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the user. If the communication is between a Perkin-Elmer ITAM 
facility and an EBCDIC facility such as an IBM System 360 or 370, 
a translated data record is received. This translation is useful 
if it ais necessary to transmit the graphic character set to an 
EBCrPIC facility, with the understanding that the data is 
interpreted as the graphic alphanumeric or special character 
EBCDIC set. If the data transmitted to the EBCDIC facility were 
binary, this conversion could be detrimental. One solution would 
be to retranslate the data back to normal state within the user 
task. A second solution would be to use the binary-transparent 
format mode described below. Transparent text mode is the 
default for binary writes using device code 163 or 171. 


6-14.2 Binary Transparent Text 


No translation of binary transparent data takes place on input or 
oupute This feature is most useful for the passage of binary 
data to an EBCDIC-oriented facility. It is the default for 
binary writes with device codes 161, 162, 169, or 170. 


Because of different buffering techniques, interlacing image and 
format I/0 requests is illegal. A violation results in an 
illegal function error status. 


Multi-record buffering is provided for transparent I/0. To allow 
for this feature, interlacing transparent and nontransparent I/0 
requests is illegal. Also, all transparent record buffering is 
performed with a constant size for all user records. This 
constant size is specified during line allocation. Improper size 
for a transparent buffer results in an illegal function error 
status. 


The LCB internal buffers are not used for SVC 1 image reads or 
writes. Hence, if only image I/0 is being performed, 
minimum-sized internal buffers should be specified during line 
allocation. 
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CHAPTER 7 
BISYNC TERMINAL MANAGER 
PROGRAM INFORMATION 


7Te1 INTRODUCTION 


The ITAM BISYNC Terminal Manager occupies 8000 bytes; the device 
control block (DCB) and channel control block (CCB), 308 
bytes/line; the line control block (LCB), 176 bytes/line. The 
LCB, in addition to the 176 bytes/line, must contain two line 
buffers. The LCB receives support from the BISYNC SVC 15 line 
driver and the common ITAM module. For line allocation, 51f-byte 
buffers are required for 3780 emulation (device codes 161,169); 
4O4-byte buffers are required for 2780 emulation (device codes 
162,170). The size of buffers for processor-to-processor (device 
codes 163,171) data depends on implementation. For device codes 
163 and 171, both ends of a processor-to-processor link must use 
buffers of the same size. To determine the best size, calculate 
the maximum size of each data record; add 5 control characters 
for nontransparent text or 7 control characters for transparent 
text; multiply that figure by the number of records to be 
included within each transmission block; and add the 8 bytes 
required by terminal-manager overhead. 


7-2 PRINCIPLES OF OPERATION 


7.2.1 Table Structure and Lefined Constants 


Refer to the ITAM Reference Manual for a description of the LCB, 
DCB, and block descriptor as well as the SVC 15 commands, command 
modifiers, data buffer control, and error status. 


Whether or not transparent text is used, device-code indices are: 


INDEX DEVICE CODE 


163 or 169 
163 or 169 (transparent) 
161 or 170 
161 or 170 (transparent) 
162 or 171 
162 or 171 (transparent) 


OBARENOS 
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Read and write format options are coded in a 


the 


device-code index. 


table 


accessed 
Each halfword is generated by adding the 


appropriate buffer-format options in the following list: 


Certain special characters and 


BFO.eSSM 


BFO.SSB 


BFO.TSM 
BFO.TSB 


BFOw.HTM 
BFO.HTB 


BFO.EMM 
BFOeEMB 


BFO.CRM 
BFO.CRB 


BFO.USM 
BFO.USB 


BFO. RSM 
BFO.TSB 


BFO.ESC 
BFO. ESC 


BFO.HTS 
BFO.HTS 


BFO.NLM 
BFO.NLB 


converted 
subroutine 


M 
B 


M 
B 


into 
for 


EQU 
EQU 


EQU 
EQU 


EQU 
EQU 


EQU 
EQU 


EQU 
EQU 


EQU 
EQU 


EQU 
EQU 


EQU 
EQU 


EQU 
EQU 


EQU 
EQU 


X¥*°8000° 
0 


X¥*4000° 
4 


X*2000° 
2 


X*°1000° 
3 


X¥*0800" 
4 


X*O400° 
5 


X*0200° 
6 


X*0100° 
7 


X*°0080° 
8 


X*° 0040 
9 


simplified 
Special-character indices are: 


Internal space suppression 


Trailing space suppression 


Horizontal tab 


End-of-medium character 


Carriage return character 


US character as ITB 


RS character as ITB 


Process ESC character 


Initialize HT map 


by 


Recognize new line character 


mainline 


indices 


special-character 
special-character 


by 


character 


sequences 


the 


are 
SPC.CHK 


determination. 
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INDEX SPECIAL CHARACTER/CHARACTER-S EQUENCE 


ACKO 
ACK1 
WACK 
RVI 


STX, DLE STX 
SOH, DLE SGH 
ETB, DLE ETB 
ETX, DLE ETX 


womOnnrnewbhrd «a 
= 
ed 
rat 


11 EOT, DLE EOT 


An error-control table (UERTAB) determines whether an error is 
recoverable and what status and extended status to return to the 
user task. One halfword is generated within the table for each 
possible error listed in the ITAM error table (ITE.-TAB). Each 
halfword can be indexed by ITE entries. The structure of each 
entry is: 

9 15 


pot tk | 
EXTENDED ITAM | RETRY STANDARD SVC 1 
STATUS | FLAG STATUS 


Standard mainline register assignment is: 


U0 Work--may be destroyed by any subroutine 
U4 DCB address 

U2 LCB address 

U3 BLK address 

U4 SVC 1 function code 

U5 SVC 1 extended options 

U6 Line status code 

U7 Level 0 subroutine linkage 

U8 Level 1 subroutine linkage 

U9 Level 2 subroutine linkage 


U10-U15 Work--may be destroyed by any subroutine 


722-2 Individual Routine Descriptions 


Following is asdescription of the BISYNC terminal manager 
CINITMBSC) routines: , 


@ INITMBSC 


Entrance from SVC 1 with LCB addressee Sets up registers U1 
and U2 to contain LCB and DCB addresses. Calls PCINIT for 
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register and LCB initialization. Depending upon whether task 
is already connected, exits to either BSIDLE or BSBUSY. 


BSIDLE 


Moves LCB parameters, device number, record length, etc., into 
the DCB by calling the SHIFT subroutine. Also, if the 
switched line needs connection, BSIDLE connects it. Exits to 
WRITINIT or READINIT. 


READINIT 


Clears horizontal-tab bit map in the LCB. Builds command and 
data-~chain pointers to perform an SVC 15 PREPARE. Enters SVC 
15 driver through SVYC15GO. On termination, returns from SVC 
15; enters RESETREG to restore environment; enters TOCHOFF to 
remove DCB from timer chain; and enters ERRORSET to check for 
any possible error. It sets line status to busy (read side 
and ACK required), sets a timer to send a WACK, and exits to 
BSBUSY3. 


WRITINIT 


Sets format records for block to a maximum of seven. Builds 
into a 2-character buffer (LCB.eBF2) the data chain and command 
pointers to write an ENQ and to read, and enters SVC 15 driver 
through SVC15G0. On return from SVC 15 driver, enters 
RESETREG to restore environment; enters TOCHOFF to remove DCB 
from driver chain; enters ERRORSET to check for possible 
error; and enters SPC.CHK to analyze the input character. An 
ACKO, the expected response, sets a TTD timer and causes an 
exit to BSBUSY3. An ENQ input during the slave mode causes a 
line turnaround. An EOT will cause an “unavailable device" 
error return. All other special-character inputs cause a 
retry. 


BSBUSY 


Puts a request into wait if the LNS.HLD bit is set. Checks 
for interlace of image and format traffic, incorrect 
transparent-~read buffers, read/write interlace, and 
eutstanding errors. Shifts parameter block information from 
LCB to DCB. Exits to READIMIG, READFORM, WRITIMIG, or 
WRITFORM,. 
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@e WRITIMIG 


Resets TTD timer and sets LNS.HLD bit. Checks for expired 
timer, I/0 in progress, invalid character ending, and EOF 
command. Builds command and data chain to WRITE BUFFER and 
READ into a two-word buffer. Exits to SVC 15 driver through 
SVC15GO, with termination return to WFTERM. 


@ READIMIG 


Resets WACK timer and sets LNS-HLD bit. Checks for expired 
timer and I/0 in progress. Builds command and data chain to 
WRITE ACK and READ data into user buffer. Exits to SVC 15 
driver through SVC15GO with termination return to RFTERM. 


@ READFORM 


Cbhtains a read-deblocking buffer. If none is available, exits 
to READER to schedule a READ, sets the LNS-HLD bit, and exits 
to IRLOUT. If buffer available, enters FORMATR to the deblock 
buffer; checks for emptied buffer; enters READER to try to 
READ ahead; and exits to DONE. 


@ READER 


First-level subroutine. Exits without a READ if I/0 is in 
progress, if no buffer is available, or if ACK is not ready on 
a WACK timer expiration. For a READ, it builds a command and 
data chain into internal buffer to WRITE ACK and READ. Exits 
to SVC 15 driver through SVC15GO, with continuation return to 
caller and termination return to RFTERM. 


e WRITFORM 


Obtains a write-blocking buffer and enters FORMATW to block 
buffer. If buffer is not full, exit to DONE is scheduled; 
otherwise, a WRITE is scheduled. No WRITE is made if an I/0 
is in progress or a TTD timer is expired. For a WRITE, it 
builds into a 2-word buffer (LCB.BF2) the SY¥YC 15 command and 
the data chains to WRITE BUFFER and READ. Exit is to SVC 15 
driver through SVC15GO, with termination return to WFTERM and 
continuation return to WRITFCNT. Depending upon line status, 
WRITFCNT exits to IRLOUT, DONE or CPT.DONE. 
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WETERM 


Entered at termination of WRITE BUFFER. Enters RESETREG’ to 
restore environment; enters TOCHOFF to remove DCB from timer 
chain; enters ERRORSET to check for errors; and enters SPC.CHK 
to validate line input character. Normal path is to WEFTGDACK, 
which complements ACK bit, clears any error status, releases 
writer buffer, and checks for a second buffer ready for output 
or checks for an EOT to be sent. On receipt of a different 
special character, these responses will be sent: 


INPUT ACTION 
Wrong ACK Send ENQ, unless following 
timeout error (ENQ was sent 


following timeout); in that case, 
the buffer is retransmitted. 


RVI Set recoverable-error flag and 
process as good ACK 


WACK Send an ENQ 
NAK Check retry count. If exhausted, 
set unrecoverable error; 


otherwise, retransmit buffer. 


ECT Set “message reject" status and 
process as unrecoverable error. 


Other Set “protocol error" status and 
Erocess aS unrecoverable error. 


Error on Read Send ENQ 


Error on Write Retry 
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@e RETERM 


Entered at termination of a READ BUFFER. Enters RESETREG to 
restore environment; enters TOCHOFF to remove DCB from timer 
chain; enters ERRORSET to check for possible errors; and 
enters SPC.CHK to check input character. Normal path (STX or 
SOH) dictates clearing all statuses, placing the buffer into 
the deblocking queue, and setting a NACK timer. Normal exit 
is to IRLOUT or READFORM, depending on the LNS.HLD bit. For 
ether input, the following action will be taken: 


INPUT ACTION 


EOT Handle as a normal buffer and let 
FORMATR later set an EOF error 


ENQ Retry 
TTD Send NACK 
Buffer Ending NACK 
with ENQ 
Error on Read NACK 
Error on Write Retry 

@ TIMERON 

Second-level subroutine. Enter with U15 containing time 


address and U9 containing termination address. Builds SVC 15 
wait command and exits to SVC 15 driver through SVC15G0O2, with 
continuation return to caller. 


@ TIMEROFF 


Second-level subroutine. Exit with zero status if expired, or 
with positive status if actually removed. Enters IS State, 
unlinks DCB, clears ISP table entry, and enters TOCHOFF to 
remove DCB from timer chain. 


e PCINIT 
Second-level subroutine. Loads extended ITAM options 
(specified or defaulted) and setS memory range to all of 
MEMOLY. 


@ ERRORSET 


Second-level subroutine. Performs journal if SGN.JRNL. not 
ZeLO. Returns with U15 equal to zero if no error occurred. 
If error occurred, determines error index, saves error index 
in LCB.LSTE, increments error count, and returns with either 
retry or unrecoverable flag. 
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Whenever possible, all line and hardware errors are retried. 
For example, if the line carrier is lost, the transmission is 
retried a specified number of times before a return to the 
user task with an “unrecoverable error" status. 


ERROR 


Determines the error status from UERTAB and the ITE index from 
LCB.LSTE, stores status into DCB, and exits to DONE or 
CPT.DONE. Clears line status, resets all timers and releases 
all buffers for an unrecoverable error, an EOF, or a zero 
error status (final transmission completion). 


SVC15GO (SVC 15 Driver Interface) 


Entered with termination address in U9 and continuation 
address in U10. User of this routine must previously 
establish data chain with LCB/DCB SCN words, put address of 
data chain into DCB.NDA, and put address of command chain into 
CCB.DCW. SV¥VC15GO sets LNS.IO bit; saves DCB.DCW contents in 
LCB.DCW to facilitate retries; clears DCB.NCE, DCB.ITB, 
CCB.IFC, DCB.ISTA, DCB.EXST, and DCB.DVST; and puts DCB on 
timer chain. User byte of continuation address must always 
have the CPNORL bit set if continuation return is wanted. 
Exit to SVC 15 driver is to address located in a SVCF, with 
DCB address in U13. 


IRLOUT 

Continuation exit. Loads DCB address into U13 and exits to 
ISSEXEC whenever more ITB bits are sete Otherwise, branches 
to EVRTE. 

RETRY 


Puts address of LCB.SCN1 into DCB.NDA; reloads DCB.DCW from 
LCB.DCW, as saved by SVC15G0O3; and exits to SVC15G0O. 


DONE 


Resets DCB.HLDB and LCBeHLDB. Exits to IODONE:; for a 
disconnect in progress, waits 100 milliseconds before exiting 


to IODONE. 


SENDEOT 
Resets any timers and builds command and data chain to write 


the one-byte EOT. At termination, it exits to ERROR or 
IRLOUT, depending on LNS.HLDB. 
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BUFFER 


Series of second-level subroutines used to perform the 
following functions: 


BUFFER 0 Release Buffer 
BUFFER 1 Obtain Write-Blocking Buffer 
BUFFER 2 Obtain Read-Deblock Buffer 
BUFFER 3 Obtain Free Buffer 
BUFFER 4 Obtain Write Buffer on Queue for Output 
BUFFER 5 Check for Free Buffer 
BUFFER 6 Check for Buffer with I/O in Progress 
BUFFER 8 Free All Buffers 
BUFFER 9 Put Buffer on Queue 
IOHMBSC 


This module interfaces the BISYNC terminal manager with the 
SVC 1 and SVC 3 (end-of-task) executors. IOHMBSC consists of 
I/O handler routines, along with an IOH list; the IOH list has 
fointers to each of the I/O handler routines. 


The address of the IOH list is assembled into the DCB.IOH 
field. Consequently, when the user task issues an SVC 1 or an 
SVC 3, the executor identifies the function request and 
vectors to the appropriate I/O handling routine, via the IOH 
list addressed in DCB.IOH. 


The I/O handling routines within IOHMBSC are described below. 


ROUTINE NAME FUNCTION 
MBS.READ SVC 1 Read 
MBS.WRIT SVC 1 Write 
MBS.WFM SVC 1 Write Filemark 
MBS.HALT | SVC 1 Halt 
MBS.WAIT SVC 41 Wait 
MBS.TEST SVC 1 Test 
MBS.EOT SVC 3 End-of-Task 
MBS.INIT System Initialization 


MBS.READ, MBS-.WRIT, and MBS.WFM share coding. If the terminal 
Manager is not busy, these routines direct it to perform the 
requested I/0 by scheduling ISSEXEC. 


If the terminal manager is busy, these routines queue the 
request to the IO0OB queue or to the leaf queue, depending on 
the following two conditions: 
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4¢ If the terminal manager is already busy with the calling task 
and the same LU, these routines queve the I/0 request to the IOB 
queve addressed by DCB.IOBQ. 


Ze If the terminal manager is busy with the calling task and a 
different LU, or with another task, these routines queue the I/0 
request to the leaf queue via a call to the LEAFQ routine. 


Once the terminal manager finishes the ongoing I/0, the routines 
schedule the ISSEXEC to have the terminal manager execute the 
queued I/O request. 


MBS.HALT, after ensuring no previous I/0 requests are pending on 
the IOB queue, calls HALTITAM, clears statuses, and exits to the 
operating system. 


MBS.WAIT calls the task manager to unchain a task from the ready 
chain when these conditions are met: the wait request is on 
behalf of the current task and the current LU; the IOB queue has 
an entry. Without these conditions, MBS.WAIT passes control to 
SVCIWAIT. 


MBS.TEST returns a condition code of zero if the leaf is 
disconnected or if the I0B queve is empty. If the leaf is 
connected and the IOB queue has an entry, MBS.TEST first searches 
the IOBs to find the IOB for the calling task and then returns a 
condition code of X'F* to indicate I/O in progress. 


MBS.EOT, entered from the SVC 3 (end-of-task) executor, ends task 
execution gracefully or immediately. 


For graceful, protocol-controlled EOT, this routine executes an 
SVC 1 wait (allowing the I/O to complete) and issues an SVC 7 
checkpoint (for a memory-resident task) or an SVC 7 close (for a 
nonresident task). If issuing an SVC 7 close, the routine also 
sets the “close in progress” bit to alert the terminal manager. 


For an immediate EOT, MBS.EOT executes a HALTITAM, instead of the 
SVC 1 wait, before issuing the SVC 7 checkpoint or SVC 7 close, 
as discussed ahove. 


MBS.INIT clears status fields in the DCB and the LCB. 
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APPENDIX A 
SUMMARY DATA DRIVER COMMAND WORDS 


MODIFIER/ 


COMMAND 
COMMAND BYTE HEX VALID COMMAND BITS 


DATA FIELD 
SPECIFIES. 


cc CT X X XXXX 00000 000 Any valid 


address 
Cc CT X O XXXX 00001 000 Halfword 
cc CT X¥ X XXXX 00010 009 Halfword 


CC CT X¥ X = XXXX 00011 009 2 halfwords 


valid address 


EXAMINE Cc cT X TO XXXX 00000 001 
RING WAIT cc cT X TO XXXX 00001 001 
ANSWER cc cf X TO XXXX 00010 001 


DISCONNECT. CC CT X TO XXXX 00011 001 


READ BUFFER CC CT BT TO XXXX 00000 010 
READ1 . CC CT BT TO XXXX 00001 019 


READ2 CC CT BT TO XXXX 00010 010 


PREP cc cT « TO XXXX 00000 011 
ANTI-PREPARE1] - CC CT Kk TO XXXX 00001 011 
ANTI-PREPARE2 CC CT K TO XXXX 00010 011 
WRITE BUFFER CC CT BT TO XXXX 00000 100. Buffer 


WRITE1 CC CT BT TO XXXX 00001 100 Byte 


WRITE2 Cc CT BT TO XXXX 00019 109 


Byte 
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APPENDIX A (Continued) 
SUMMARY DATA DRIVER COMMAND WORDS ° 


MODIFIER/ NO. 
COMMAND DATA DATA FIELD 
COMMAND BYTE HEX VALID COMMAND BITS FIELDS SPECIFIES 


TO XXXX 00000 Halfword 


TOUT 00000 Fullword 
CMD2 x 00001 Byte 
RCMD 00010 = Byte 
WCMD 00010 Byte 
RDIS 00100 Byte 
WDIS 00101 Byte 
DISC 00110 ‘Byte 
SYCT 00111 | Byte 
TRNSL 01000 . Byte 


SPEC CHAR 01001 Fullvord 


TRECS 01010 Halfword 


The default values assenbled in DCB160, DCB161, DCB162, and DCB153 for the above parameters are: 


TOUT Dc 4'°5°,H'S* 5 seconds for read and write 

CMD2 DB O Not applicable for 201 adapter 

RCMD DB x*49* Enable, DTR, read 

WCHMD DB X*4UA* Enable, DTR, write 

RDIS DB x*89° Disable, DIR, read 

WDIS DB X's89°* Disable, DTR, read (drops RQ2S for HDX) 
ptsc DB x*ait* Disable, read 

SYCT DB x‘'ou' 5 leading syncs 

TRNSL D8 93 ASCII for control, normal, and transparent 
TRECS Dc 4*809° 89-Byte transparent records 

XLT DAC BEBC.TOP ESCDIC on the line 


The default values for DCB168, DCB169, DCB170, and DCB171 are: 


TOUT Doc H°5*,H'5S° 5 seconds for read and write 

CMD2 DB x*39° Q3A prograa command 

RCD DB xX*59°* Enable read 

WCMD DB xX*SR* Enable write 

RDIS DB X*D9* Disable read 

SYCT DB X*O4u* 5 leading syncs 

TRNSL .. DB O ASCII for control, normal, and transparent 
TRECS DC H°80° 8)-Byte transparent records 

XLT DAC BEBC.TOP EBCDIC on the line 
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APPENDIX B 


PARAMETER BLOCK FORMATS 
SVC 15 PARAMETER BLOCK 


FUNCTION CODE BITS 


Halt I/O Call 
Command Trap Enable 
Buffer Trap Enable 
Termination Trap 
Reserved 


DATA CODES 


X"00" 
x"ou" 
x°08" 
X'go° 
K*o1" 


Direct Text 
Indirect Text 
Chained Buffers 
Transfer in Data 
DCW Parameter 
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A(DC#) 
| A(Data Area 1) 
A(Data Area 2) 

e 

e 


A( Data Area n) 


APPENDIX B (Continued) 


BIT NO. BIT 13-15 
O=Command Chained 000 Null 
1=Command Trap 001 Control 
2=Buffer Traps 010 Read 
3=Time-Out 011 Prepare 

100 Write 
101 Hold 
110 Mode 


SVC 1 PARAMETER BLOCK 


0(0) 1¢1) 2(2) Device 3(3) Device 
Function Code Logical Unit Independent Dependent 
Status . Status 


Buffer Start Address 


Buffer End Address 


Random Address 


16( 10) Length of Transfer 


20( 14) Extended Options 
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APPENDIX C 
TRANSLATION TABLES 


The ITAM BISYNC Line Driver supports American Standard Code for 


Information Interchange (ASCII) and Extended Binary Coded Decimal 


Interchange Code (EBCDIC) for transmission over the 
communications line. Using the translation feature of the auto 
driver channel, data can be maintained in memory in either FBCDIC 
or ASCII. The following pages contain these translation tables 
used by the BISYNC line driver: 


e EBCDIC-to-ASCII 


@ ASCII-to-EBCDIC 


NOTE 


This appendix does not include the 
ASCII-to-ASCII translation tables for 
even and odd parity because these tables 
merely add and delete parity bits for 
writes and reads. 
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ASCII 
CODE 
00 


APPENDIX C (Continued) 


TABLE C-1 ASCII-to-EBCDIC TRANSLATION 


CHAR- | EBCDIC ASCII CHAR- | EBCDIC ASCII CHAR- | EBCDIC 
ACTER CODE CODE |} ACTER CODE CODE ACTER CODE 
00 2B 


“hoo -KON<XE< 


OANA AHRWNH O™* 


WH ee TTN KX KX SES OCCTVF TODOS RZ THT TTS FTA OT 


QO 
ell ud. 


< 
> 
? 
@ 
A 
B 
C 
D 
E 
F 
G 
H 
| 
J 
K 
L. 
M 
N 
O 
P 
Q 
R 
S 
T 
U 


0 
7 
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APPENDIX C (Continued) 


TABLE C~1 ASCII-to-FBCDIC TRANSLATION (Continued) 


ASCII CHAR- | EBCDIC ASCII 
CODE ACTER CODE CODE 
81 DC 06 AC 


AD 
AE 
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EBCDIC ASCII CHAR- EBCDIC 
CODE CODE ACTER CODE 
AC D7 57 


EBCDIC 
CODE 
00 


APPENDIX C (Continued) 


TABLE C-2 EBCDIC-to-ASCII TRANSLATION 


CHAR- ASCII }|EBCDIC CHAR- ASCII EBCDIC | CHAR- ASCII 
ACTER CODE CODE ACTER CODE CODE ACTER CODE 
00 2B 98 56 D6 
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APPENDIX C (Continued) 
TABLE C-2 EBCDIC-to-ASCII TRANSLATION (Continued) 
EBCDIC CHAR- ASCII EBCDIC ASCII EBCDIC CHAR- ASCII 
CODE ACTER CODE CODE CODE CODE ACTER CODE 
81 61 AC AC D7 P 50 


82 
83 


DO 


—-~ syraowroagaonaya 2 


N<xxs<ca 


-~ZroaTm7mmMooovyp™ 


2 


OMOnN OOH WH =| © 


N< XK S< co" 
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INDEX 


Adapter commands, 3-18, 3-19 
Adapter strapping, 1-1 
ANSWER, 3-1, 3-3, 4-6 
ANTI-PREPARE1, 3-1, 3-10, 4-6 
ANTI-PREPARE2, 3-1, 3-10, 4-6 


BCC, 2-4, 3-5, 3-6, 3-11, 4-10 
Binary synchronous communications, See BSC 
Binary transparent text, 6-15, 6-16 
Binary synchrecnous control characters, 2-2, 6-15 
Binary synchronous line driver, 1-1, 4-1, 4-7 
Binary synchronous transmission modes, 2-2 
control mode 
ncermal-text mode 
transparent-text mode 
Block, 6-13 
Block check character, See ECC 
BSC, 1-27 2-1¢ 5-14 67-1 


Carriage return, 6-11 

CCB, §=1p 7-1 

Channel contrel block, See CCB 
Commands, line driver, 1-2, 3-1 
Control characters, BISYNC, 2-2, 6-15. 
Control mode, 2-2, 2-3, 2-4, 3-4 
Control operations, 4-6 

CRC, 3-4, 3-5, 4-4, 4-5, 6-14 
CUP/32, 5-3 

CXFER, 3-1 

Cyclic redundancy check, See CRC 


Data link escape, See DLE 
DCB, 1-3, 7-1 

DCW, 3-20 

DCW chain, 4-10 

Device codes, 7-1 

Device contrcl block, See DCB 
Device statements, 1-2 
DISCONNECT, 3-1, 3-4, 4-6 
DLE, 272 

DLE, 2-5 

Driver command word, See [CW 
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Encoded termination codes, 3-8 
End-of-medium, 6-12 

EOT, 272 

EQT, 2-2 

ESC, 6-10, 6-11 

Escape character, See ESC 

ETX, 2-2 

EXAMINE, 3-1, 3-2, 4-6 

Extended device code, 5-3, 5-4 
Extended ITAM options, 6-7, 6-8, 6-9. 


Format read, 6-2 

Format read/writes, 6-12 

Format write, 6-2 

Formatting, ty terminal manager, 6-9 


Horizontal tabulation, 6-10 
Image read/write, 6-3 


LCB, 5-5, 6-16, 7-1 

Line control block, See LCB 

Line driver, Binary synchronous, 1-1, 4-1, 4-7 
Line-driver access, See SVC 1£& access 
Longitudinal redundancy check, See LRC 

LRC, 4-4, 4-5 


Message, 6-13 

MODE commands, 3-1, 3-13, 3-14, 3-16, 3-17, 4-6 
Mode operations, 4-6 

MPBSR instruction, 5-5 


NAK, 272 

NOP, 3-1, 3-2 

Normal-text mode, 2-4, 2-&, 3-4, 3-5, 3-11, 4-2 
Nuli operations, 4-6 


Pad character, 2-1, 4-3 
PREPARE, 3-1, 3-10, 4-5 
Prepare operations, 4-5 
Processor-to-processor interface, 5-3, 6-9 


REAT, 3-1, 3-4, Ye 

Read operations, 4-4 
READ1, 3-1, 3-4, 4-4 
REALD2, 3-1, 3-4, 4-4 
Record, 6-12 

Record buffering, 6-12 
Register assignment, 7-3 
Remote job entry, See RJE 
RING WAIT, 3-1, 3-3, 4-6 
RJE, 5-2, 5-3 
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SCH, 27-2 é 

Space suppression, 6-9 

Special characters, 7-3 
Special-character handling, 3-4, 4-€& 
SSA, 171 

Status byte, adapter, 3-3 

Status code processing, 6-3 

Status, SVC 16, 3-7, 3-8 

Stick character, 2-3, 3-5, 4-8, 4-9, ‘4-10 
Strapping, adapter, 5-2 

STX, 2-2 

SVC 1 access, 5-1, 5-4, 6-1 

SVC 1 status codes, 6-3, 6-6 

SVC 15 access, 1-2, 6-1 

SVC 15 function code, 3-21/3-22 

SVC 7, 5-5 

SYNC, 2-2 

SYNC character, 1-2, 2-1 

Synchronous set adapter, See SSA 
SYNC-search mcde, adapter, 3-4, 3-10 


Temporary Text delay, See TTL 

Terminal manager, BISYNC, 5-1, 6-1, 7-1 
Terminal manager routines, 7-3 
Terminal-manager access, See SVC 1 access 
Termination sequences, 3-5 

Timeout values, 3-17 

Translation tables, 4-6 

Transmission, 6-13 

Transparent text, 6-12, 6-15 


Traneparent-text mode, 2-5, 2-6, 3-4, 3-6, 


TTD, 2-5 
Unit separator, 6-12 


WAIT, 3-1, 3-2 
WRITE, 3-1, 3-10, 4-2 
Write filemark, 6-3 

Write operaticns, 4-2 
Write routines/,1- 

WRITE, 3-1, 3-10, 4Y- 
WRITE2, 3-1, 3-10, 4- 
Write/read binary, 6- 


toy NO Nh 


XFER, 3-1 
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